naftiko: 1.0.0-alpha2
info:
  label: RingCentral API — Call Log
  description: 'RingCentral API — Call Log. 9 operations. Lead operation: List Company Active Calls. Self-contained Naftiko
    capability covering one Ringcentral business surface.'
  tags:
  - Ringcentral
  - Call Log
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    RINGCENTRAL_API_KEY: RINGCENTRAL_API_KEY
capability:
  consumes:
  - type: http
    namespace: platform-call-log
    baseUri: https://platform.ringcentral.com
    description: RingCentral API — Call Log business capability. Self-contained, no shared references.
    resources:
    - name: restapi-v1.0-account-accountId-active-calls
      path: /restapi/v1.0/account/{accountId}/active-calls
      operations:
      - name: listcompanyactivecalls
        method: GET
        description: List Company Active Calls
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: Indicates the page number to retrieve. Only positive number values are accepted
        - name: perPage
          in: query
          type: integer
          description: Indicates the page size (number of items)
    - name: restapi-v1.0-account-accountId-call-log
      path: /restapi/v1.0/account/{accountId}/call-log
      operations:
      - name: readcompanycalllog
        method: GET
        description: List Company Call Records
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: Indicates the page number to retrieve. Only positive number values are accepted
        - name: perPage
          in: query
          type: integer
          description: Indicates the page size (number of items)
    - name: restapi-v1.0-account-accountId-call-log-sync
      path: /restapi/v1.0/account/{accountId}/call-log-sync
      operations:
      - name: syncaccountcalllog
        method: GET
        description: Sync Company Call Log
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: syncToken
          in: query
          type: string
          description: Value of syncToken property of last sync request response. Mandatory parameter for 'ISync' sync type
        - name: dateFrom
          in: query
          type: string
          description: The start datetime for resulting records in ISO 8601 format including timezone, for example 2016-03-10T18:07:52.534Z.
            The default value is the current moment
        - name: recordCount
          in: query
          type: integer
          description: For `FSync` mode this parameter is mandatory, it limits the number of records to be returned in response.
        - name: showDeleted
          in: query
          type: boolean
          description: Supported for `ISync` mode. Indicates that deleted call records should be returned
    - name: restapi-v1.0-account-accountId-call-log-callRecordId
      path: /restapi/v1.0/account/{accountId}/call-log/{callRecordId}
      operations:
      - name: readcompanycallrecord
        method: GET
        description: Get Company Call Record(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: restapi-v1.0-account-accountId-extension-extensionId-active-calls
      path: /restapi/v1.0/account/{accountId}/extension/{extensionId}/active-calls
      operations:
      - name: listextensionactivecalls
        method: GET
        description: List User Active Calls
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: Indicates the page number to retrieve. Only positive number values are allowed
        - name: perPage
          in: query
          type: integer
          description: Indicates the page size (number of items)
    - name: restapi-v1.0-account-accountId-extension-extensionId-call-log
      path: /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-log
      operations:
      - name: readusercalllog
        method: GET
        description: List User Call Records
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: Indicates the page number to retrieve. Only positive number values are allowed
        - name: perPage
          in: query
          type: integer
          description: Indicates the page size (number of items). The default value is 100.
        - name: showDeleted
          in: query
          type: boolean
          description: Indicates that deleted calls records should be returned
      - name: deleteusercalllog
        method: DELETE
        description: Delete User Call Records
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dateTo
          in: query
          type: string
          description: The time boundary to delete all older records in ISO 8601 format including
    - name: restapi-v1.0-account-accountId-extension-extensionId-call-log-sync
      path: /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-log-sync
      operations:
      - name: syncusercalllog
        method: GET
        description: Sync User Call Log
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: syncToken
          in: query
          type: string
          description: A `syncToken` value from the previous sync response (for `ISync` mode only, mandatory)
        - name: dateFrom
          in: query
          type: string
          description: The start datetime for resulting records in ISO 8601 format including
        - name: recordCount
          in: query
          type: integer
          description: For `FSync` mode this parameter is mandatory, it limits the number of records to be returned in response.
        - name: showDeleted
          in: query
          type: boolean
          description: Supported for `ISync` mode. Indicates that deleted call records should be returned
    - name: restapi-v1.0-account-accountId-extension-extensionId-call-log-callRecordId
      path: /restapi/v1.0/account/{accountId}/extension/{extensionId}/call-log/{callRecordId}
      operations:
      - name: readusercallrecord
        method: GET
        description: Get User Call Record(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.RINGCENTRAL_API_KEY}}'
  exposes:
  - type: rest
    namespace: platform-call-log-rest
    port: 8080
    description: REST adapter for RingCentral API — Call Log. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/restapi/v1-0/account/{accountid}/active-calls
      name: restapi-v1-0-account-accountid-active-calls
      description: REST surface for restapi-v1.0-account-accountId-active-calls.
      operations:
      - method: GET
        name: listcompanyactivecalls
        description: List Company Active Calls
        call: platform-call-log.listcompanyactivecalls
        with:
          page: rest.page
          perPage: rest.perPage
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/restapi/v1-0/account/{accountid}/call-log
      name: restapi-v1-0-account-accountid-call-log
      description: REST surface for restapi-v1.0-account-accountId-call-log.
      operations:
      - method: GET
        name: readcompanycalllog
        description: List Company Call Records
        call: platform-call-log.readcompanycalllog
        with:
          page: rest.page
          perPage: rest.perPage
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/restapi/v1-0/account/{accountid}/call-log-sync
      name: restapi-v1-0-account-accountid-call-log-sync
      description: REST surface for restapi-v1.0-account-accountId-call-log-sync.
      operations:
      - method: GET
        name: syncaccountcalllog
        description: Sync Company Call Log
        call: platform-call-log.syncaccountcalllog
        with:
          syncToken: rest.syncToken
          dateFrom: rest.dateFrom
          recordCount: rest.recordCount
          showDeleted: rest.showDeleted
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/restapi/v1-0/account/{accountid}/call-log/{callrecordid}
      name: restapi-v1-0-account-accountid-call-log-callrecordid
      description: REST surface for restapi-v1.0-account-accountId-call-log-callRecordId.
      operations:
      - method: GET
        name: readcompanycallrecord
        description: Get Company Call Record(s)
        call: platform-call-log.readcompanycallrecord
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/restapi/v1-0/account/{accountid}/extension/{extensionid}/active-calls
      name: restapi-v1-0-account-accountid-extension-extensionid-active-calls
      description: REST surface for restapi-v1.0-account-accountId-extension-extensionId-active-calls.
      operations:
      - method: GET
        name: listextensionactivecalls
        description: List User Active Calls
        call: platform-call-log.listextensionactivecalls
        with:
          page: rest.page
          perPage: rest.perPage
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/restapi/v1-0/account/{accountid}/extension/{extensionid}/call-log
      name: restapi-v1-0-account-accountid-extension-extensionid-call-log
      description: REST surface for restapi-v1.0-account-accountId-extension-extensionId-call-log.
      operations:
      - method: GET
        name: readusercalllog
        description: List User Call Records
        call: platform-call-log.readusercalllog
        with:
          page: rest.page
          perPage: rest.perPage
          showDeleted: rest.showDeleted
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteusercalllog
        description: Delete User Call Records
        call: platform-call-log.deleteusercalllog
        with:
          dateTo: rest.dateTo
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/restapi/v1-0/account/{accountid}/extension/{extensionid}/call-log-sync
      name: restapi-v1-0-account-accountid-extension-extensionid-call-log-sync
      description: REST surface for restapi-v1.0-account-accountId-extension-extensionId-call-log-sync.
      operations:
      - method: GET
        name: syncusercalllog
        description: Sync User Call Log
        call: platform-call-log.syncusercalllog
        with:
          syncToken: rest.syncToken
          dateFrom: rest.dateFrom
          recordCount: rest.recordCount
          showDeleted: rest.showDeleted
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/restapi/v1-0/account/{accountid}/extension/{extensionid}/call-log/{callrecordid}
      name: restapi-v1-0-account-accountid-extension-extensionid-call-log-callrecordid
      description: REST surface for restapi-v1.0-account-accountId-extension-extensionId-call-log-callRecordId.
      operations:
      - method: GET
        name: readusercallrecord
        description: Get User Call Record(s)
        call: platform-call-log.readusercallrecord
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: platform-call-log-mcp
    port: 9090
    transport: http
    description: MCP adapter for RingCentral API — Call Log. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: list-company-active-calls
      description: List Company Active Calls
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: platform-call-log.listcompanyactivecalls
      with:
        page: tools.page
        perPage: tools.perPage
      outputParameters:
      - type: object
        mapping: $.
    - name: list-company-call-records
      description: List Company Call Records
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: platform-call-log.readcompanycalllog
      with:
        page: tools.page
        perPage: tools.perPage
      outputParameters:
      - type: object
        mapping: $.
    - name: sync-company-call-log
      description: Sync Company Call Log
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: platform-call-log.syncaccountcalllog
      with:
        syncToken: tools.syncToken
        dateFrom: tools.dateFrom
        recordCount: tools.recordCount
        showDeleted: tools.showDeleted
      outputParameters:
      - type: object
        mapping: $.
    - name: get-company-call-record-s
      description: Get Company Call Record(s)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: platform-call-log.readcompanycallrecord
      outputParameters:
      - type: object
        mapping: $.
    - name: list-user-active-calls
      description: List User Active Calls
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: platform-call-log.listextensionactivecalls
      with:
        page: tools.page
        perPage: tools.perPage
      outputParameters:
      - type: object
        mapping: $.
    - name: list-user-call-records
      description: List User Call Records
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: platform-call-log.readusercalllog
      with:
        page: tools.page
        perPage: tools.perPage
        showDeleted: tools.showDeleted
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-user-call-records
      description: Delete User Call Records
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: platform-call-log.deleteusercalllog
      with:
        dateTo: tools.dateTo
      outputParameters:
      - type: object
        mapping: $.
    - name: sync-user-call-log
      description: Sync User Call Log
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: platform-call-log.syncusercalllog
      with:
        syncToken: tools.syncToken
        dateFrom: tools.dateFrom
        recordCount: tools.recordCount
        showDeleted: tools.showDeleted
      outputParameters:
      - type: object
        mapping: $.
    - name: get-user-call-record-s
      description: Get User Call Record(s)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: platform-call-log.readusercallrecord
      outputParameters:
      - type: object
        mapping: $.