Associated Press AP Media API — Monitors and Alerts

naftiko: 1.0.0-alpha2
info:
  label: Associated Press AP Media API — Monitors and Alerts
  description: 'Associated Press AP Media API — Monitors and Alerts. 10 operations. Lead operation: Associated Press List
    your Monitors. (formerly /account/monitors/get). Self-contained Naftiko capability covering one Associated Press business
    surface.'
  tags:
  - Associated Press
  - Monitors and Alerts
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ASSOCIATED_PRESS_API_KEY: ASSOCIATED_PRESS_API_KEY
capability:
  consumes:
  - type: http
    namespace: meda-monitors-and-alerts
    baseUri: ''
    description: Associated Press AP Media API — Monitors and Alerts business capability. Self-contained, no shared references.
    resources:
    - name: account-monitors
      path: /account/monitors
      operations:
      - name: get
        method: GET
        description: Associated Press List your Monitors. (formerly /account/monitors/get)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: account-monitors-alerts
      path: /account/monitors/alerts
      operations:
      - name: get
        method: GET
        description: Associated Press View recent Alerts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: show_detail
          in: query
          type: boolean
          description: Return full details of Monitors and latest Alert
        - name: agentid
          in: query
          type: string
          description: Constrain operation to one Agent
    - name: account-monitors-create
      path: /account/monitors/create
      operations:
      - name: post
        method: POST
        description: Associated Press Create a new Monitor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: account-monitors-sessions
      path: /account/monitors/sessions
      operations:
      - name: get
        method: GET
        description: Associated Press View recent Sessions that have Monitors.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: show_detail
          in: query
          type: boolean
          description: Return full details of Monitors and latest Alert
        - name: agentid
          in: query
          type: string
          description: Constrain operation to one Agent
    - name: account-monitors-sessions-session_id
      path: /account/monitors/sessions/{session_id}
      operations:
      - name: get
        method: GET
        description: Associated Press View one Session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique ID for a Session
          required: true
        - name: show_detail
          in: query
          type: boolean
          description: Return full details of Monitors and latest Alert
    - name: account-monitors-sessions-session_id-disable
      path: /account/monitors/sessions/{session_id}/disable
      operations:
      - name: get
        method: GET
        description: Associated Press Disable a Monitor on a Session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique ID for a Session
          required: true
        - name: agentid
          in: query
          type: string
          description: Constrain operation to one Agent
    - name: account-monitors-sessions-session_id-enable
      path: /account/monitors/sessions/{session_id}/enable
      operations:
      - name: get
        method: GET
        description: Associated Press Enable a Monitor on a Session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique ID for a Session
          required: true
        - name: agentid
          in: query
          type: string
          description: Constrain operation to one Agent
    - name: account-monitors-monitorId
      path: /account/monitors/{monitorId}
      operations:
      - name: get
        method: GET
        description: Associated Press View one Monitor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: monitorId
          in: path
          type: string
          description: The unique name or ID of the desired Monitor
          required: true
    - name: account-monitors-monitorId-delete
      path: /account/monitors/{monitorId}/delete
      operations:
      - name: delete
        method: DELETE
        description: Associated Press Delete a Monitor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: monitorId
          in: path
          type: string
          description: The unique name or ID of the Monitor
          required: true
    - name: account-monitors-monitorId-update
      path: /account/monitors/{monitorId}/update
      operations:
      - name: post
        method: POST
        description: Associated Press Update a Monitor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: monitorId
          in: path
          type: string
          description: The unique name or ID of the Monitor
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: x-api-key
      value: '{{env.ASSOCIATED_PRESS_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: meda-monitors-and-alerts-rest
    port: 8080
    description: REST adapter for Associated Press AP Media API — Monitors and Alerts. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/account/monitors
      name: account-monitors
      description: REST surface for account-monitors.
      operations:
      - method: GET
        name: get
        description: Associated Press List your Monitors. (formerly /account/monitors/get)
        call: meda-monitors-and-alerts.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/account/monitors/alerts
      name: account-monitors-alerts
      description: REST surface for account-monitors-alerts.
      operations:
      - method: GET
        name: get
        description: Associated Press View recent Alerts
        call: meda-monitors-and-alerts.get
        with:
          show_detail: rest.show_detail
          agentid: rest.agentid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/account/monitors/create
      name: account-monitors-create
      description: REST surface for account-monitors-create.
      operations:
      - method: POST
        name: post
        description: Associated Press Create a new Monitor
        call: meda-monitors-and-alerts.post
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/account/monitors/sessions
      name: account-monitors-sessions
      description: REST surface for account-monitors-sessions.
      operations:
      - method: GET
        name: get
        description: Associated Press View recent Sessions that have Monitors.
        call: meda-monitors-and-alerts.get
        with:
          show_detail: rest.show_detail
          agentid: rest.agentid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/account/monitors/sessions/{session-id}
      name: account-monitors-sessions-session-id
      description: REST surface for account-monitors-sessions-session_id.
      operations:
      - method: GET
        name: get
        description: Associated Press View one Session
        call: meda-monitors-and-alerts.get
        with:
          session_id: rest.session_id
          show_detail: rest.show_detail
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/account/monitors/sessions/{session-id}/disable
      name: account-monitors-sessions-session-id-disable
      description: REST surface for account-monitors-sessions-session_id-disable.
      operations:
      - method: GET
        name: get
        description: Associated Press Disable a Monitor on a Session
        call: meda-monitors-and-alerts.get
        with:
          session_id: rest.session_id
          agentid: rest.agentid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/account/monitors/sessions/{session-id}/enable
      name: account-monitors-sessions-session-id-enable
      description: REST surface for account-monitors-sessions-session_id-enable.
      operations:
      - method: GET
        name: get
        description: Associated Press Enable a Monitor on a Session
        call: meda-monitors-and-alerts.get
        with:
          session_id: rest.session_id
          agentid: rest.agentid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/account/monitors/{monitorid}
      name: account-monitors-monitorid
      description: REST surface for account-monitors-monitorId.
      operations:
      - method: GET
        name: get
        description: Associated Press View one Monitor
        call: meda-monitors-and-alerts.get
        with:
          monitorId: rest.monitorId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/account/monitors/{monitorid}/delete
      name: account-monitors-monitorid-delete
      description: REST surface for account-monitors-monitorId-delete.
      operations:
      - method: DELETE
        name: delete
        description: Associated Press Delete a Monitor
        call: meda-monitors-and-alerts.delete
        with:
          monitorId: rest.monitorId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/account/monitors/{monitorid}/update
      name: account-monitors-monitorid-update
      description: REST surface for account-monitors-monitorId-update.
      operations:
      - method: POST
        name: post
        description: Associated Press Update a Monitor
        call: meda-monitors-and-alerts.post
        with:
          monitorId: rest.monitorId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: meda-monitors-and-alerts-mcp
    port: 9090
    transport: http
    description: MCP adapter for Associated Press AP Media API — Monitors and Alerts. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: associated-press-list-your-monitors
      description: Associated Press List your Monitors. (formerly /account/monitors/get)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meda-monitors-and-alerts.get
      outputParameters:
      - type: object
        mapping: $.
    - name: associated-press-view-recent-alerts
      description: Associated Press View recent Alerts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meda-monitors-and-alerts.get
      with:
        show_detail: tools.show_detail
        agentid: tools.agentid
      outputParameters:
      - type: object
        mapping: $.
    - name: associated-press-create-new-monitor
      description: Associated Press Create a new Monitor
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: meda-monitors-and-alerts.post
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: associated-press-view-recent-sessions
      description: Associated Press View recent Sessions that have Monitors.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meda-monitors-and-alerts.get
      with:
        show_detail: tools.show_detail
        agentid: tools.agentid
      outputParameters:
      - type: object
        mapping: $.
    - name: associated-press-view-one-session
      description: Associated Press View one Session
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meda-monitors-and-alerts.get
      with:
        session_id: tools.session_id
        show_detail: tools.show_detail
      outputParameters:
      - type: object
        mapping: $.
    - name: associated-press-disable-monitor-session
      description: Associated Press Disable a Monitor on a Session
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meda-monitors-and-alerts.get
      with:
        session_id: tools.session_id
        agentid: tools.agentid
      outputParameters:
      - type: object
        mapping: $.
    - name: associated-press-enable-monitor-session
      description: Associated Press Enable a Monitor on a Session
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meda-monitors-and-alerts.get
      with:
        session_id: tools.session_id
        agentid: tools.agentid
      outputParameters:
      - type: object
        mapping: $.
    - name: associated-press-view-one-monitor
      description: Associated Press View one Monitor
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meda-monitors-and-alerts.get
      with:
        monitorId: tools.monitorId
      outputParameters:
      - type: object
        mapping: $.
    - name: associated-press-delete-monitor
      description: Associated Press Delete a Monitor
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: meda-monitors-and-alerts.delete
      with:
        monitorId: tools.monitorId
      outputParameters:
      - type: object
        mapping: $.
    - name: associated-press-update-monitor
      description: Associated Press Update a Monitor
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: meda-monitors-and-alerts.post
      with:
        monitorId: tools.monitorId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.