Southwest Power Pool

Southwest Power Pool Monitoring Sets API

[Monitoring Sets](https://trolie.energy/concepts#monitoring-sets) are named sets of power system resources that may be used to filter ratings and limits returned by queries against these APIs. How Monitoring Sets are defined is beyond the scope of the TROLIE specification, and it is assumed that the sender and receiver have predefined the appropriate Monitoring Sets.

GitHub OpenAPI

Operations 5

POST /monitoring-sets Create a new monitoring set #
GET /monitoring-sets/{id} Obtain a specific monitoring set by identifier. #
PUT /monitoring-sets/{id} Update an existing monitoring set #
DELETE /monitoring-sets/{id} Delete a specific monitoring set by its identifier #
GET /default-monitoring-set Obtain your default monitoring set. #

Documentation

📖
Documentation
https://www.spp.org/documents/72496/spp%20lep%20api%20data%20exchange%20guide.pdf

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/spp/refs/heads/main/openapi/spp-monitoring-sets-api-openapi.yml

Other Resources

🔗
Specification
https://trolie.energy/spec

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/spp-monitoring-sets-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

spp-monitoring-sets-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Transmission Ratings and Operating Limits Information Exchange (TROLIE) Monitoring Sets API
  x-logo:
    altText: TROLIE logo
    url: images/TROLIE-horizontal-color.svg
  description: "\nThis specification defines a set of operations for the exchange of power\nsystem ratings and limits between entities that own and operate the electric\npower system in North America. In particular, it is designed to support the\nexchange of Ambient Adjusted Ratings (AARs), pursuant to FERC Order 881.  It\nis published as a community standard to facilitate interoperability\nin these exchanges.\n\nThe specification conceives of the exchange as being between two primary\nentities:\n\n* A [Ratings Provider](https://trolie.energy/concepts#ratings-provider) is\n an entity that is responsible for providing ratings on some set of power\n system resources, e.g., Transmission Facilities, typically a Transmission\n Owner or Transmission Operator.  The ratings are provided to a\n Clearinghouse Provider whose is responsible for determining the operating\n limits of the power system resources.\n\n* The [Clearinghouse Provider](https://trolie.energy/concepts#clearinghouse-provider) is\n  typically a Transmission Provider (FERC) and a Reliability Coordinator (NERC).\n\nAdjacent Clearinghouse Providers exchange ratings in order to establish\noperating limit values for the power system resources that are shared\nbetween them.\n\nA Ratings Provider is assumed by this specification to have pre-coordinated \nwith a Clearinghouse Provider to identify the former's Ratings Obligation,\ni.e., the set of power system resources for which they will provide ratings.\nAdditionally, the Ratings Provider will have similarly pre-coordinated the\ndefinition of their Monitoring Sets, i.e., their power system limits of\ninterest. The nature and method of pre-coordination is out-of-scope for this\nspecification.\n\nNote that this API makes a strict distinction between the terms rating and\nlimit.  Colloquially, these terms are often used interchangeably.  However,\nin the context of this specification, they have distinct meanings. At a\nhigh-level, the specification defines an exchange where ratings go in and\nlimits come out. A Clearinghouse is a function for determining the operating\nlimits from the ratings it has on-hand, including those that are proposed by\nRatings Providers and any applicable time-bound static ratings.\n\nThis interaction diagram highlights the primary requests and responses that\nare defined in this spec. Note that not all of the operations will be\nsupported by every implementation.\n\n<img src=\"images/interactions.excalidraw.png\" alt=\"Primary Interactions with Ratings Provider\" />\n"
  version: 1.1.0
  contact:
    name: TROLIE Maintainers
    email: maintainers@trolie.energy
    url: https://trolie.energy
  license:
    name: Community Specification License 1.0
    url: https://spdx.org/licenses/Community-Spec-1.0.html
servers:
- url: https://trolie.example.com
security:
- oauth2-primary-flow: []
tags:
- name: Monitoring Sets
  description: '

    [Monitoring Sets](https://trolie.energy/concepts#monitoring-sets) are

    named sets of power system resources that may be used to filter ratings

    and limits returned by queries against these APIs. How Monitoring Sets are

    defined is beyond the scope of the TROLIE specification, and it is assumed

    that the sender and receiver have predefined the appropriate Monitoring

    Sets.

    '
paths:
  /monitoring-sets:
    post:
      operationId: createMonitoringSet
      description: '

        Create a new monitoring set. The server will assign a unique identifier and

        source info to the monitoring set upon creation. This information will be

        available in the monitoring set `source` header and in the HTTP `Location`

        header.


        A 409 Conflict may be returned depending on the implementation. For example,

        if the monitoring set id that would be generated conflicts with an existing

        monitoring set, as could be the case if the id was generated by the client.

        As another example, a provided `alternate-identifiers` entry may conflict

        with existing identifiers.

        '
      summary: Create a new monitoring set
      tags:
      - Monitoring Sets
      requestBody:
        required: true
        content:
          application/vnd.trolie.monitoring-set-request.v1+json:
            schema:
              $ref: '#/components/schemas/request'
      responses:
        '201':
          description: The monitoring set was created
          content:
            application/vnd.trolie.monitoring-set.v1+json:
              schema:
                $ref: '#/components/schemas/response'
              example:
                source:
                  last-updated: '2025-10-31T15:05:43.044267100-07:00'
                  provider: RC-NERC-ID
                  origin-id: 5aeacb25-9b65-4738-8a00-ac10afa63640
                id: UTILITY123
                description: Lines in utility 123's footprint and immediate neighbors
                power-system-resources:
                - resource-id: urn:uuid:01925421-0766-771a-a92d-1631a49f647c
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.12345
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001785-A
                    type: AssetRegForm
                    authority: RC-NERC-ID
                - resource-id: urn:uuid:01925421-b967-78de-a746-7497c5105939
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.67890
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001787-C
                    type: AssetRegForm
                    authority: RC-NERC-ID
            application/vnd.trolie.monitoring-set.v2+json:
              schema:
                $ref: '#/components/schemas/response_v2'
              example:
                source:
                  last-updated: '2025-10-31T15:05:43.044267100-07:00'
                  provider: RC-NERC-ID
                  origin-id: 5aeacb25-9b65-4738-8a00-ac10afa63640
                id: urn:uuid:5c1f8d0b-a170-4e5e-9f74-a35e6be170b4
                name: UTILITY123
                description: Lines in utility 123's footprint and immediate neighbors
                power-system-resources:
                - resource-id: urn:uuid:01925421-0766-771a-a92d-1631a49f647c
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.12345
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001785-A
                    type: AssetRegForm
                    authority: RC-NERC-ID
                - resource-id: urn:uuid:01925421-b967-78de-a746-7497c5105939
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.67890
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001787-C
                    type: AssetRegForm
                    authority: RC-NERC-ID
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/X-Rate-Limit-Limit'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/X-Rate-Limit-Remaining'
            X-Rate-Limit-Reset:
              $ref: '#/components/headers/X-Rate-Limit-Reset'
            ETag:
              $ref: '#/components/headers/ETag'
            Location:
              $ref: '#/components/headers/Location'
        '400':
          $ref: '#/components/responses/400-problem'
        '401':
          $ref: '#/components/responses/401-empty'
        '403':
          $ref: '#/components/responses/403-empty'
        '406':
          $ref: '#/components/responses/406-problem'
        '409':
          description: Conflict
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/problem'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/X-Rate-Limit-Limit'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/X-Rate-Limit-Remaining'
            X-Rate-Limit-Reset:
              $ref: '#/components/headers/X-Rate-Limit-Reset'
        '413':
          $ref: '#/components/responses/413-empty'
        '415':
          $ref: '#/components/responses/415-problem'
        '422':
          $ref: '#/components/responses/422-problem'
        '429':
          $ref: '#/components/responses/429-empty'
        '500':
          $ref: '#/components/responses/500-empty'
        default:
          $ref: '#/components/responses/500-empty'
      security:
      - oauth2-primary-flow:
        - write:monitoring-sets
  /monitoring-sets/{id}:
    get:
      operationId: getMonitoringSet
      description: Obtain a specific monitoring set by identifier.
      summary: Obtain a specific monitoring set by identifier.
      tags:
      - Monitoring Sets
      parameters:
      - $ref: '#/components/parameters/path-filter'
      responses:
        '200':
          description: OK
          content:
            application/vnd.trolie.monitoring-set.v1+json:
              schema:
                $ref: '#/components/schemas/response'
              example:
                source:
                  last-updated: '2025-10-31T15:05:43.044267100-07:00'
                  provider: RC-NERC-ID
                  origin-id: 5aeacb25-9b65-4738-8a00-ac10afa63640
                id: UTILITY123
                description: Lines in utility 123's footprint and immediate neighbors
                power-system-resources:
                - resource-id: urn:uuid:01925421-0766-771a-a92d-1631a49f647c
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.12345
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001785-A
                    type: AssetRegForm
                    authority: RC-NERC-ID
                - resource-id: urn:uuid:01925421-b967-78de-a746-7497c5105939
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.67890
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001787-C
                    type: AssetRegForm
                    authority: RC-NERC-ID
            application/vnd.trolie.monitoring-set.v2+json:
              schema:
                $ref: '#/components/schemas/response_v2'
              example:
                source:
                  last-updated: '2025-10-31T15:05:43.044267100-07:00'
                  provider: RC-NERC-ID
                  origin-id: 5aeacb25-9b65-4738-8a00-ac10afa63640
                id: urn:uuid:5c1f8d0b-a170-4e5e-9f74-a35e6be170b4
                name: UTILITY123
                description: Lines in utility 123's footprint and immediate neighbors
                power-system-resources:
                - resource-id: urn:uuid:01925421-0766-771a-a92d-1631a49f647c
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.12345
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001785-A
                    type: AssetRegForm
                    authority: RC-NERC-ID
                - resource-id: urn:uuid:01925421-b967-78de-a746-7497c5105939
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.67890
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001787-C
                    type: AssetRegForm
                    authority: RC-NERC-ID
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/X-Rate-Limit-Limit'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/X-Rate-Limit-Remaining'
            X-Rate-Limit-Reset:
              $ref: '#/components/headers/X-Rate-Limit-Reset'
            ETag:
              $ref: '#/components/headers/ETag'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400-problem'
        '401':
          $ref: '#/components/responses/401-empty'
        '403':
          $ref: '#/components/responses/403-empty'
        '404':
          $ref: '#/components/responses/404-empty'
        '406':
          $ref: '#/components/responses/406-problem'
        '429':
          $ref: '#/components/responses/429-empty'
        '500':
          $ref: '#/components/responses/500-empty'
        default:
          $ref: '#/components/responses/500-empty'
      security:
      - oauth2-primary-flow:
        - read:monitoring-sets
    put:
      operationId: updateMonitoringSet
      description: '

        Update an existing monitoring set.

        Returns 403 Forbidden if the monitoring set is read-only.

        Returns 404 Not Found if the monitoring set does not exist or the principal

        does not have read access to it.


        A 409 Conflict may be returned depending on the implementation. For example,

        a provided `alternate-identifiers` entry may conflict with existing

        identifiers.


        A 422 Unprocessable Entity may be returned if the request body is

        semantically invalid. For example, if any of the power system resources

        defined in the monitoring set cannot be found; you cannot monitor a facility

        that does not exist.

        '
      summary: Update an existing monitoring set
      tags:
      - Monitoring Sets
      parameters:
      - $ref: '#/components/parameters/path-filter'
      requestBody:
        required: true
        content:
          application/vnd.trolie.monitoring-set.v1+json:
            schema:
              $ref: '#/components/schemas/response'
            example:
              source:
                last-updated: '2025-10-31T15:05:43.044267100-07:00'
                provider: RC-NERC-ID
                origin-id: 5aeacb25-9b65-4738-8a00-ac10afa63640
              id: UTILITY123
              description: Lines in utility 123's footprint and immediate neighbors
              power-system-resources:
              - resource-id: urn:uuid:01925421-0766-771a-a92d-1631a49f647c
                alternate-identifiers:
                - name: MYSUBSTN.LN.12345
                  type: EMSID
                  authority: RC-NERC-ID
                - name: X-00001785-A
                  type: AssetRegForm
                  authority: RC-NERC-ID
              - resource-id: urn:uuid:01925421-b967-78de-a746-7497c5105939
                alternate-identifiers:
                - name: MYSUBSTN.LN.67890
                  type: EMSID
                  authority: RC-NERC-ID
                - name: X-00001787-C
                  type: AssetRegForm
                  authority: RC-NERC-ID
      responses:
        '204':
          $ref: '#/components/responses/204'
        '400':
          $ref: '#/components/responses/400-problem'
        '401':
          $ref: '#/components/responses/401-empty'
        '403':
          $ref: '#/components/responses/403-empty'
        '404':
          $ref: '#/components/responses/404-empty'
        '406':
          $ref: '#/components/responses/406-problem'
        '409':
          $ref: '#/components/responses/409'
        '413':
          $ref: '#/components/responses/413-empty'
        '415':
          $ref: '#/components/responses/415-problem'
        '422':
          $ref: '#/components/responses/422-problem'
        '429':
          $ref: '#/components/responses/429-empty'
        '500':
          $ref: '#/components/responses/500-empty'
        default:
          $ref: '#/components/responses/500-empty'
      security:
      - oauth2-primary-flow:
        - write:monitoring-sets
    delete:
      operationId: deleteMonitoringSet
      description: '

        Delete a specific monitoring set by its identifier. Returns 403 Forbidden if

        the monitoring set is read-only. Returns 404 Not Found if the monitoring set

        does not exist or the principal does not have read access to it.  Returns

        409 Conflict if the monitoring set cannot be deleted, for example, if it is

        currently the authenticated principal''s default monitoring set.

        '
      summary: Delete a specific monitoring set by its identifier
      tags:
      - Monitoring Sets
      parameters:
      - $ref: '#/components/parameters/path-filter'
      responses:
        '204':
          $ref: '#/components/responses/204'
        '400':
          $ref: '#/components/responses/400-problem'
        '401':
          $ref: '#/components/responses/401-empty'
        '403':
          $ref: '#/components/responses/403-empty'
        '404':
          $ref: '#/components/responses/404-empty'
        '409':
          $ref: '#/components/responses/409'
        '429':
          $ref: '#/components/responses/429-empty'
        '500':
          $ref: '#/components/responses/500-empty'
        default:
          $ref: '#/components/responses/500-empty'
      security:
      - oauth2-primary-flow:
        - write:monitoring-sets
  /default-monitoring-set:
    get:
      operationId: getDefaultMonitoringSet
      summary: Obtain your default monitoring set.
      description: '

        Obtain the default monitoring set for the authorized principal.  TROLIE

        implementations SHOULD provide a default monitoring set for each principal.

        The default monitoring set is the monitoring set that is used for limits

        snapshots when the `monitoring-set-id` query parameter is not supplied.

        '
      tags:
      - Monitoring Sets
      responses:
        '200':
          description: OK
          content:
            application/vnd.trolie.monitoring-set.v1+json:
              schema:
                $ref: '#/components/schemas/response'
              example:
                source:
                  last-updated: '2025-10-31T15:05:43.044267100-07:00'
                  provider: RC-NERC-ID
                  origin-id: 5aeacb25-9b65-4738-8a00-ac10afa63640
                id: UTILITY123
                description: Lines in utility 123's footprint and immediate neighbors
                power-system-resources:
                - resource-id: urn:uuid:01925421-0766-771a-a92d-1631a49f647c
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.12345
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001785-A
                    type: AssetRegForm
                    authority: RC-NERC-ID
                - resource-id: urn:uuid:01925421-b967-78de-a746-7497c5105939
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.67890
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001787-C
                    type: AssetRegForm
                    authority: RC-NERC-ID
            application/vnd.trolie.monitoring-set.v2+json:
              schema:
                $ref: '#/components/schemas/response_v2'
              example:
                source:
                  last-updated: '2025-10-31T15:05:43.044267100-07:00'
                  provider: RC-NERC-ID
                  origin-id: 5aeacb25-9b65-4738-8a00-ac10afa63640
                id: urn:uuid:5c1f8d0b-a170-4e5e-9f74-a35e6be170b4
                name: UTILITY123
                description: Lines in utility 123's footprint and immediate neighbors
                power-system-resources:
                - resource-id: urn:uuid:01925421-0766-771a-a92d-1631a49f647c
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.12345
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001785-A
                    type: AssetRegForm
                    authority: RC-NERC-ID
                - resource-id: urn:uuid:01925421-b967-78de-a746-7497c5105939
                  alternate-identifiers:
                  - name: MYSUBSTN.LN.67890
                    type: EMSID
                    authority: RC-NERC-ID
                  - name: X-00001787-C
                    type: AssetRegForm
                    authority: RC-NERC-ID
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/X-Rate-Limit-Limit'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/X-Rate-Limit-Remaining'
            X-Rate-Limit-Reset:
              $ref: '#/components/headers/X-Rate-Limit-Reset'
            ETag:
              $ref: '#/components/headers/ETag'
        '304':
          $ref: '#/components/responses/304'
        '400':
          $ref: '#/components/responses/400-problem'
        '401':
          $ref: '#/components/responses/401-empty'
        '403':
          $ref: '#/components/responses/403-empty'
        '404':
          $ref: '#/components/responses/404-empty'
        '406':
          $ref: '#/components/responses/406-problem'
        '429':
          $ref: '#/components/responses/429-empty'
        '500':
          $ref: '#/components/responses/500-empty'
        default:
          $ref: '#/components/responses/500-empty'
      security:
      - oauth2-primary-flow:
        - read:monitoring-sets
components:
  responses:
    403-empty:
      description: Access denied
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
      content:
        application/*:
          schema:
            $ref: '#/components/schemas/empty'
    400-problem:
      description: Malformed request
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/problem'
    '304':
      description: Not Modified.
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
    '409':
      description: Conflict
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/problem'
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
    429-empty:
      description: Too many requests (rate limiting)
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
      content:
        application/*:
          schema:
            $ref: '#/components/schemas/empty'
    415-problem:
      description: Unsupported media type
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
        Accept:
          schema:
            type: string
            pattern: ^((application\/vnd\.trolie\.(?:[a-z-]+)\.v\d+\+json(;q=(0\.\d+|1\.0))?))(\,\s*(application\/vnd\.trolie\.(?:[a-z-]+)\.v\d+\+json(;q=(0\.\d+|1\.0))?))*$
            maxLength: 500
          examples:
            Forecast Proposal:
              summary: Used to update the area-wide forecast
              value: application/vnd.trolie.rating-forecast-proposal.v1+json
            Real-Time Proposal:
              summary: Used to update the area-wide nowcast
              value: application/vnd.trolie.rating-realtime-proposal.v1+json
        Accept-Encoding:
          description: 'The server must support and prefer Brotli yet must accept gzip for

            compatibility.

            '
          schema:
            type: string
            enum:
            - br,gzip
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/problem'
    500-empty:
      description: An unexpected error occurred
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
      content:
        application/*:
          schema:
            $ref: '#/components/schemas/empty'
    404-empty:
      description: Not Found
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
      content:
        application/*:
          schema:
            $ref: '#/components/schemas/empty'
    406-problem:
      description: Not Acceptable (Content negotiation failed)
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/problem'
    '204':
      description: Operation successful. No Content.
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
        ETag:
          $ref: '#/components/headers/ETag'
    401-empty:
      description: Unauthorized
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
      content:
        application/*:
          schema:
            $ref: '#/components/schemas/empty'
    413-empty:
      description: Payload too large
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
      content:
        application/*:
          schema:
            $ref: '#/components/schemas/empty'
    422-problem:
      description: Unprocessable content
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/X-Rate-Limit-Limit'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/X-Rate-Limit-Remaining'
        X-Rate-Limit-Reset:
          $ref: '#/components/headers/X-Rate-Limit-Reset'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/problem'
  schemas:
    named-power-system-resources:
      type: array
      minItems: 1
      maxItems: 50000
      description: Collection of power system resource names
      items:
        $ref: '#/components/schemas/names'
    problem:
      description: See [RFC9457](https://www.rfc-editor.org/rfc/rfc9457#appendix-A).
      type: object
      properties:
        type:
          type: string
          format: uri-reference
          maxLength: 2048
          description: 'A URI reference that identifies the problem type.

            See [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457#name-type)

            '
          example: https://iana.org/assignments/http-problem-types#date
        title:
          type: string
          format: free-text
          maxLength: 500
          description: 'A short, human-readable summary of the problem type.

            See [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457#name-title)

            '
        status:
          type: number
          minimum: 100
          maximum: 599
          description: 'The HTTP status code generated by the origin server for this occurrence of the problem.

            '
        detail:
          type: string
          format: free-text
          maxLength: 500
          description: A human-readable explanation specific to this occurrence of the problem. See [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457#name-detail)
        instance:
          type: string
          format: uri-reference
          maxLength: 2048
          description: 'A URI reference that identifies the specific occurrence of the problem.

            It may or may not yield further information if dereferenced.

            See [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457#name-status)

            '
          example: https://iana.org/assignments/http-problem-types#date
      required:
      - type
    response:
      type: object
      description: "See https://trolie.energy/concepts.html#monitoring-sets for info on the \nmonitoring set concept in TROLIE.  \n\nThis representation is intended to be enough for consumers to read it and tell where \nthe monitoring set came from, using metadata such as a source and an optional description.  \nIt also includes the list of resources included in the monitoring set, as well as all\ntheir known aliases.  \n"
      properties:
        name:
          type: string
          description: A human-readable name for this monitoring set
          maxLength: 255
          minLength: 1
          pattern: ^[a-zA-Z0-9 _-]{1,255}$
        description:
          type: string
          format: free-form
          description: A description of this monitoring set
          maxLength: 1000
        power-system-resources:
          $ref: '#/components/schemas/named-power-system-resources'
        source:
          $ref: '#/components/schemas/data-provenance'
        id:
          $ref: '#/components/schemas/local'
      required:
      - source
      - id
      - power-system-resources
    data-provenance:
      type: object
      description: "\nProvides information about where the associated representation came from. *No\nfunctional aspects of the exchange are contingent upon this data.* However,\nthis information is meant to support debugging and application support use\ncases, so implementors are encouraged to provide\nmeaningful values.\n\n* `provider` identifies that entity, e.g., a Ratings Provider or Clearinghouse\n  Provider, that created the object. The `provider`'s NERC id is recommended.\n* `last-updated` indicates the wall-clock time at the `provider` when the\n  object was last modified. N.b. this is not when the message\n  describing the object was sent or received, i.e., implementors should not\n  simply insert the current timestamp here when preparing the object serialization.\n* `origin-id` is the identifier used by the `provider` to uniquely nominate\n  the object. It is recommended but not required that this be a URI.\n"
      properties:
        provider:
          $ref: '#/components/schemas/entity'
        last-updated:
          $ref: '#/components/schemas/timestamp'
        origin-id:
          $ref: '#/components/schemas/local'
      required:
      - provider
      - last-updated
    request:
      type: object
      description: '

        Request body for creating a monitoring set. The server will assign an id and

        source upon successful creation.


        Note that any `alternate-identifiers` supplied in the request should be

        should be used by the server to define an alternate identifier for the

        associated with a power system resource. In this way monitoring sets can be

        used to introduce use case specific names f

# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/spp/refs/heads/main/openapi/spp-monitoring-sets-api-openapi.yml