Miro Developer Platform — Audit Logs

naftiko: 1.0.0-alpha2
info:
  label: Miro Developer Platform — Audit Logs
  description: 'Miro Developer Platform — Audit Logs. 1 operations. Lead operation: Get audit logs. Self-contained Naftiko
    capability covering one Miro business surface.'
  tags:
  - Miro
  - Audit Logs
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MIRO_API_KEY: MIRO_API_KEY
capability:
  consumes:
  - type: http
    namespace: miro-audit-logs
    baseUri: https://api.miro.com
    description: Miro Developer Platform — Audit Logs business capability. Self-contained, no shared references.
    resources:
    - name: v2-audit-logs
      path: /v2/audit/logs
      operations:
      - name: enterprisegetauditlogs
        method: GET
        description: Get audit logs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: createdAfter
          in: query
          type: string
          description: 'Retrieve audit logs created after the date and time provided. This is the start date of the duration
            for which you want to retrieve audit logs. For example, if '
          required: true
        - name: createdBefore
          in: query
          type: string
          description: Retrieve audit logs created before the date and time provided. This is the end date of the duration
            for which you want to retrieve audit logs. For example, if y
          required: true
        - name: cursor
          in: query
          type: string
          description: A cursor-paginated method returns a portion of the total set of results based on the `limit` specified
            and a `cursor` that points to the next portion of the res
        - name: limit
          in: query
          type: integer
          description: Maximum number of results returned based on the `limit` specified in the request. For example, if there
            are `30` results, the request has no `cursor` value, and
        - name: sorting
          in: query
          type: string
          description: Sort order in which you want to view the result set. Based on the value you provide, the results are
            sorted in an ascending or descending order of the audit log
    authentication:
      type: bearer
      token: '{{env.MIRO_API_KEY}}'
  exposes:
  - type: rest
    namespace: miro-audit-logs-rest
    port: 8080
    description: REST adapter for Miro Developer Platform — Audit Logs. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v2/audit/logs
      name: v2-audit-logs
      description: REST surface for v2-audit-logs.
      operations:
      - method: GET
        name: enterprisegetauditlogs
        description: Get audit logs
        call: miro-audit-logs.enterprisegetauditlogs
        with:
          createdAfter: rest.createdAfter
          createdBefore: rest.createdBefore
          cursor: rest.cursor
          limit: rest.limit
          sorting: rest.sorting
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: miro-audit-logs-mcp
    port: 9090
    transport: http
    description: MCP adapter for Miro Developer Platform — Audit Logs. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: get-audit-logs
      description: Get audit logs
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: miro-audit-logs.enterprisegetauditlogs
      with:
        createdAfter: tools.createdAfter
        createdBefore: tools.createdBefore
        cursor: tools.cursor
        limit: tools.limit
        sorting: tools.sorting
      outputParameters:
      - type: object
        mapping: $.