naftiko: 1.0.0-alpha2
info:
  label: 'Webex Cloud Calling — Location Call Settings:  Schedules'
  description: 'Webex Cloud Calling — Location Call Settings:  Schedules. 9 operations. Lead operation: Read the List of Schedules.
    Self-contained Naftiko capability covering one Webex business surface.'
  tags:
  - Webex
  - 'Location Call Settings:  Schedules'
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WEBEX_API_KEY: WEBEX_API_KEY
capability:
  consumes:
  - type: http
    namespace: cloud-calling-location-call-settings-schedules
    baseUri: ''
    description: 'Webex Cloud Calling — Location Call Settings:  Schedules business capability. Self-contained, no shared
      references.'
    resources:
    - name: telephony-config-locations-locationId-schedules
      path: /telephony/config/locations/{locationId}/schedules
      operations:
      - name: readthelistofschedules
        method: GET
        description: Read the List of Schedules
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Return the list of schedules for this location.
          required: true
        - name: orgId
          in: query
          type: string
          description: List schedules for this organization.
        - name: max
          in: query
          type: number
          description: Limit the number of objects returned to this maximum count.
        - name: start
          in: query
          type: number
          description: Start at the zero-based offset in the list of matching objects.
        - name: name
          in: query
          type: string
          description: Only return schedules with the matching name.
        - name: type
          in: query
          type: string
          description: Type of the schedule.
      - name: createaschedule
        method: POST
        description: Create a Schedule
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Create the schedule for this location.
          required: true
        - name: orgId
          in: query
          type: string
          description: Create the schedule for this organization.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-locations-locationId-schedules-type-scheduleId
      path: /telephony/config/locations/{locationId}/schedules/{type}/{scheduleId}
      operations:
      - name: getdetailsforaschedule
        method: GET
        description: Get Details for a Schedule
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Retrieve schedule details in this location.
          required: true
        - name: type
          in: path
          type: string
          description: Type of the schedule.
          required: true
        - name: scheduleId
          in: path
          type: string
          description: Retrieve the schedule with the matching ID.
          required: true
        - name: orgId
          in: query
          type: string
          description: Retrieve schedule details from this organization.
      - name: updateaschedule
        method: PUT
        description: Update a Schedule
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Location in which this schedule exists.
          required: true
        - name: type
          in: path
          type: string
          description: Type of schedule.
          required: true
        - name: scheduleId
          in: path
          type: string
          description: Update schedule with the matching ID.
          required: true
        - name: orgId
          in: query
          type: string
          description: Update schedule from this organization.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteaschedule
        method: DELETE
        description: Delete a Schedule
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Location from which to delete a schedule.
          required: true
        - name: type
          in: path
          type: string
          description: Type of the schedule.
          required: true
        - name: scheduleId
          in: path
          type: string
          description: Delete the schedule with the matching ID.
          required: true
        - name: orgId
          in: query
          type: string
          description: Delete the schedule from this organization.
    - name: telephony-config-locations-locationId-schedules-type-scheduleId-events
      path: /telephony/config/locations/{locationId}/schedules/{type}/{scheduleId}/events
      operations:
      - name: createascheduleevent
        method: POST
        description: Create a Schedule Event
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Create the schedule for this location.
          required: true
        - name: type
          in: path
          type: string
          description: Type of schedule.
          required: true
        - name: scheduleId
          in: path
          type: string
          description: Create event for a given schedule ID.
          required: true
        - name: orgId
          in: query
          type: string
          description: Create the schedule for this organization.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-locations-locationId-schedules-type-scheduleId-events-eventId
      path: /telephony/config/locations/{locationId}/schedules/{type}/{scheduleId}/events/{eventId}
      operations:
      - name: getdetailsforascheduleevent
        method: GET
        description: Get Details for a Schedule Event
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Retrieve schedule event details in this location.
          required: true
        - name: type
          in: path
          type: string
          description: Type of schedule.
          required: true
        - name: scheduleId
          in: path
          type: string
          description: Retrieve the schedule event with the matching schedule ID.
          required: true
        - name: eventId
          in: path
          type: string
          description: Retrieve the schedule event with the matching schedule event ID.
          required: true
        - name: orgId
          in: query
          type: string
          description: Retrieve schedule event details from this organization.
      - name: updateascheduleevent
        method: PUT
        description: Update a Schedule Event
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Location in which this schedule event exists.
          required: true
        - name: type
          in: path
          type: string
          description: Type of schedule.
          required: true
        - name: scheduleId
          in: path
          type: string
          description: Update schedule event with the matching schedule ID.
          required: true
        - name: eventId
          in: path
          type: string
          description: Update the schedule event with the matching schedule event ID.
          required: true
        - name: orgId
          in: query
          type: string
          description: Update schedule from this organization.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteascheduleevent
        method: DELETE
        description: Delete a Schedule Event
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Location from which to delete a schedule.
          required: true
        - name: type
          in: path
          type: string
          description: Type of schedule.
          required: true
        - name: scheduleId
          in: path
          type: string
          description: Delete the schedule with the matching ID.
          required: true
        - name: eventId
          in: path
          type: string
          description: Delete the schedule event with the matching schedule event ID.
          required: true
        - name: orgId
          in: query
          type: string
          description: Delete the schedule from this organization.
    authentication:
      type: bearer
      token: '{{env.WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: cloud-calling-location-call-settings-schedules-rest
    port: 8080
    description: 'REST adapter for Webex Cloud Calling — Location Call Settings:  Schedules. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.'
    resources:
    - path: /v1/telephony/config/locations/{locationid}/schedules
      name: telephony-config-locations-locationid-schedules
      description: REST surface for telephony-config-locations-locationId-schedules.
      operations:
      - method: GET
        name: readthelistofschedules
        description: Read the List of Schedules
        call: cloud-calling-location-call-settings-schedules.readthelistofschedules
        with:
          locationId: rest.locationId
          orgId: rest.orgId
          max: rest.max
          start: rest.start
          name: rest.name
          type: rest.type
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createaschedule
        description: Create a Schedule
        call: cloud-calling-location-call-settings-schedules.createaschedule
        with:
          locationId: rest.locationId
          orgId: rest.orgId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/locations/{locationid}/schedules/{type}/{scheduleid}
      name: telephony-config-locations-locationid-schedules-type-scheduleid
      description: REST surface for telephony-config-locations-locationId-schedules-type-scheduleId.
      operations:
      - method: GET
        name: getdetailsforaschedule
        description: Get Details for a Schedule
        call: cloud-calling-location-call-settings-schedules.getdetailsforaschedule
        with:
          locationId: rest.locationId
          type: rest.type
          scheduleId: rest.scheduleId
          orgId: rest.orgId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateaschedule
        description: Update a Schedule
        call: cloud-calling-location-call-settings-schedules.updateaschedule
        with:
          locationId: rest.locationId
          type: rest.type
          scheduleId: rest.scheduleId
          orgId: rest.orgId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteaschedule
        description: Delete a Schedule
        call: cloud-calling-location-call-settings-schedules.deleteaschedule
        with:
          locationId: rest.locationId
          type: rest.type
          scheduleId: rest.scheduleId
          orgId: rest.orgId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/locations/{locationid}/schedules/{type}/{scheduleid}/events
      name: telephony-config-locations-locationid-schedules-type-scheduleid-events
      description: REST surface for telephony-config-locations-locationId-schedules-type-scheduleId-events.
      operations:
      - method: POST
        name: createascheduleevent
        description: Create a Schedule Event
        call: cloud-calling-location-call-settings-schedules.createascheduleevent
        with:
          locationId: rest.locationId
          type: rest.type
          scheduleId: rest.scheduleId
          orgId: rest.orgId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/locations/{locationid}/schedules/{type}/{scheduleid}/events/{eventid}
      name: telephony-config-locations-locationid-schedules-type-scheduleid-events-eventid
      description: REST surface for telephony-config-locations-locationId-schedules-type-scheduleId-events-eventId.
      operations:
      - method: GET
        name: getdetailsforascheduleevent
        description: Get Details for a Schedule Event
        call: cloud-calling-location-call-settings-schedules.getdetailsforascheduleevent
        with:
          locationId: rest.locationId
          type: rest.type
          scheduleId: rest.scheduleId
          eventId: rest.eventId
          orgId: rest.orgId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateascheduleevent
        description: Update a Schedule Event
        call: cloud-calling-location-call-settings-schedules.updateascheduleevent
        with:
          locationId: rest.locationId
          type: rest.type
          scheduleId: rest.scheduleId
          eventId: rest.eventId
          orgId: rest.orgId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteascheduleevent
        description: Delete a Schedule Event
        call: cloud-calling-location-call-settings-schedules.deleteascheduleevent
        with:
          locationId: rest.locationId
          type: rest.type
          scheduleId: rest.scheduleId
          eventId: rest.eventId
          orgId: rest.orgId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cloud-calling-location-call-settings-schedules-mcp
    port: 9090
    transport: http
    description: 'MCP adapter for Webex Cloud Calling — Location Call Settings:  Schedules. One tool per consumed operation,
      routed inline through this capability''s consumes block.'
    tools:
    - name: read-list-schedules
      description: Read the List of Schedules
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-location-call-settings-schedules.readthelistofschedules
      with:
        locationId: tools.locationId
        orgId: tools.orgId
        max: tools.max
        start: tools.start
        name: tools.name
        type: tools.type
      outputParameters:
      - type: object
        mapping: $.
    - name: create-schedule
      description: Create a Schedule
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-calling-location-call-settings-schedules.createaschedule
      with:
        locationId: tools.locationId
        orgId: tools.orgId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-details-schedule
      description: Get Details for a Schedule
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-location-call-settings-schedules.getdetailsforaschedule
      with:
        locationId: tools.locationId
        type: tools.type
        scheduleId: tools.scheduleId
        orgId: tools.orgId
      outputParameters:
      - type: object
        mapping: $.
    - name: update-schedule
      description: Update a Schedule
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: cloud-calling-location-call-settings-schedules.updateaschedule
      with:
        locationId: tools.locationId
        type: tools.type
        scheduleId: tools.scheduleId
        orgId: tools.orgId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-schedule
      description: Delete a Schedule
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: cloud-calling-location-call-settings-schedules.deleteaschedule
      with:
        locationId: tools.locationId
        type: tools.type
        scheduleId: tools.scheduleId
        orgId: tools.orgId
      outputParameters:
      - type: object
        mapping: $.
    - name: create-schedule-event
      description: Create a Schedule Event
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-calling-location-call-settings-schedules.createascheduleevent
      with:
        locationId: tools.locationId
        type: tools.type
        scheduleId: tools.scheduleId
        orgId: tools.orgId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-details-schedule-event
      description: Get Details for a Schedule Event
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-location-call-settings-schedules.getdetailsforascheduleevent
      with:
        locationId: tools.locationId
        type: tools.type
        scheduleId: tools.scheduleId
        eventId: tools.eventId
        orgId: tools.orgId
      outputParameters:
      - type: object
        mapping: $.
    - name: update-schedule-event
      description: Update a Schedule Event
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: cloud-calling-location-call-settings-schedules.updateascheduleevent
      with:
        locationId: tools.locationId
        type: tools.type
        scheduleId: tools.scheduleId
        eventId: tools.eventId
        orgId: tools.orgId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-schedule-event
      description: Delete a Schedule Event
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: cloud-calling-location-call-settings-schedules.deleteascheduleevent
      with:
        locationId: tools.locationId
        type: tools.type
        scheduleId: tools.scheduleId
        eventId: tools.eventId
        orgId: tools.orgId
      outputParameters:
      - type: object
        mapping: $.