Gremlin API — reliability-tests

naftiko: 1.0.0-alpha2
info:
  label: Gremlin API — reliability-tests
  description: 'Gremlin API — reliability-tests. 12 operations. Lead operation: Get all reliability tests.. Self-contained
    Naftiko capability covering one Gremlin business surface.'
  tags:
  - Gremlin
  - reliability-tests
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GREMLIN_API_KEY: GREMLIN_API_KEY
capability:
  consumes:
  - type: http
    namespace: gremlin-reliability-tests
    baseUri: https://api.gremlin.com/v1
    description: Gremlin API — reliability-tests business capability. Self-contained, no shared references.
    resources:
    - name: reliability-tests
      path: /reliability-tests
      operations:
      - name: getallreliabilitytests
        method: GET
        description: Get all reliability tests.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
    - name: reliability-tests-active
      path: /reliability-tests/active
      operations:
      - name: getactivereliabilitytests
        method: GET
        description: Get active reliability tests.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
    - name: reliability-tests-active-paged
      path: /reliability-tests/active/paged
      operations:
      - name: getpaginatedactivereliabilitytests
        method: GET
        description: Get a team's active reliability tests in descending order by start time.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: pageSize
          in: query
          type: integer
          description: This value determines how many results will be returned per call.
        - name: pageToken
          in: query
          type: string
          description: Pass the pageToken to get the next page of active reliability test runs
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
    - name: reliability-tests-completed-paged
      path: /reliability-tests/completed/paged
      operations:
      - name: getpaginatedcompletedreliabilitytestruns
        method: GET
        description: Get a team's completed reliability test runs ordered by start time desc.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: pageSize
          in: query
          type: integer
          description: This value determines how many results will be returned per call.
        - name: pageToken
          in: query
          type: string
          description: Pass the pageToken to get the next page of completed reliability test runs
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
    - name: reliability-tests-next-runs
      path: /reliability-tests/next-runs
      operations:
      - name: getpendingservicereliabilityruns
        method: GET
        description: Get pending reliability test runs for service, ordered by expected trigger time via schedule or Run All.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: serviceId
          in: query
          type: string
          description: serviceId for which to look for runs
          required: true
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
    - name: reliability-tests-notifications
      path: /reliability-tests/notifications
      operations:
      - name: getnotificationsforteam
        method: GET
        description: Get all notifications for a team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: sinceDays
          in: query
          type: integer
          description: Notifications since days
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
    - name: reliability-tests-preview
      path: /reliability-tests/preview
      operations:
      - name: previewgraph
        method: GET
        description: Takes a given scenario and transforms it for turning into a reliability test
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: scenarioType
          in: query
          type: string
          required: true
        - name: scenarioId
          in: query
          type: string
          required: true
        - name: policyCategory
          in: query
          type: string
          required: true
    - name: reliability-tests-recent-runs
      path: /reliability-tests/recent-runs
      operations:
      - name: getrecentreliabilitytestruns
        method: GET
        description: Get recently completed reliability test runs ordered by endDate desc. for a service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: serviceId
          in: query
          type: string
          description: serviceId for which to look for runs
          required: true
        - name: pageSize
          in: query
          type: integer
          description: This value determines how many results will be returned per call.
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
    - name: reliability-tests-runs
      path: /reliability-tests/runs
      operations:
      - name: getallreliabilityruns
        method: GET
        description: Get all reliability test runs ordered by createdDate desc.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: serviceId
          in: query
          type: string
          description: serviceId for which to look for runs
          required: true
        - name: pageSize
          in: query
          type: integer
          description: This value determines how many results will be returned per call.
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
    - name: reliability-tests-reliabilityTestId
      path: /reliability-tests/{reliabilityTestId}
      operations:
      - name: getreliabilitytest
        method: GET
        description: Get a single company-scoped reliability test.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reliabilityTestId
          in: path
          type: string
          required: true
    - name: reliability-tests-reliabilityTestId-runs
      path: /reliability-tests/{reliabilityTestId}/runs
      operations:
      - name: getallreliabilityrunsforreliabilitytest
        method: GET
        description: Get all reliability test runs for a reliabilityTest ordered by createdDate desc.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reliabilityTestId
          in: path
          type: string
          required: true
        - name: serviceId
          in: query
          type: string
          description: serviceId for which to look for runs
          required: true
        - name: dependencyId
          in: query
          type: string
          description: dependency for which to look for runs
        - name: failureFlagName
          in: query
          type: string
          description: failureFlagName for which to look for runs
        - name: pageSize
          in: query
          type: integer
          description: This value determines how many results will be returned per call.
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
      - name: runreliabilitytestforservice
        method: POST
        description: Run a reliability test for a service.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reliabilityTestId
          in: path
          type: string
          required: true
        - name: teamId
          in: query
          type: string
          description: Required when using company session token.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: gremlin-reliability-tests-rest
    port: 8080
    description: REST adapter for Gremlin API — reliability-tests. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/reliability-tests
      name: reliability-tests
      description: REST surface for reliability-tests.
      operations:
      - method: GET
        name: getallreliabilitytests
        description: Get all reliability tests.
        call: gremlin-reliability-tests.getallreliabilitytests
        with:
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/active
      name: reliability-tests-active
      description: REST surface for reliability-tests-active.
      operations:
      - method: GET
        name: getactivereliabilitytests
        description: Get active reliability tests.
        call: gremlin-reliability-tests.getactivereliabilitytests
        with:
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/active/paged
      name: reliability-tests-active-paged
      description: REST surface for reliability-tests-active-paged.
      operations:
      - method: GET
        name: getpaginatedactivereliabilitytests
        description: Get a team's active reliability tests in descending order by start time.
        call: gremlin-reliability-tests.getpaginatedactivereliabilitytests
        with:
          pageSize: rest.pageSize
          pageToken: rest.pageToken
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/completed/paged
      name: reliability-tests-completed-paged
      description: REST surface for reliability-tests-completed-paged.
      operations:
      - method: GET
        name: getpaginatedcompletedreliabilitytestruns
        description: Get a team's completed reliability test runs ordered by start time desc.
        call: gremlin-reliability-tests.getpaginatedcompletedreliabilitytestruns
        with:
          pageSize: rest.pageSize
          pageToken: rest.pageToken
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/next-runs
      name: reliability-tests-next-runs
      description: REST surface for reliability-tests-next-runs.
      operations:
      - method: GET
        name: getpendingservicereliabilityruns
        description: Get pending reliability test runs for service, ordered by expected trigger time via schedule or Run All.
        call: gremlin-reliability-tests.getpendingservicereliabilityruns
        with:
          serviceId: rest.serviceId
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/notifications
      name: reliability-tests-notifications
      description: REST surface for reliability-tests-notifications.
      operations:
      - method: GET
        name: getnotificationsforteam
        description: Get all notifications for a team
        call: gremlin-reliability-tests.getnotificationsforteam
        with:
          sinceDays: rest.sinceDays
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/preview
      name: reliability-tests-preview
      description: REST surface for reliability-tests-preview.
      operations:
      - method: GET
        name: previewgraph
        description: Takes a given scenario and transforms it for turning into a reliability test
        call: gremlin-reliability-tests.previewgraph
        with:
          scenarioType: rest.scenarioType
          scenarioId: rest.scenarioId
          policyCategory: rest.policyCategory
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/recent-runs
      name: reliability-tests-recent-runs
      description: REST surface for reliability-tests-recent-runs.
      operations:
      - method: GET
        name: getrecentreliabilitytestruns
        description: Get recently completed reliability test runs ordered by endDate desc. for a service
        call: gremlin-reliability-tests.getrecentreliabilitytestruns
        with:
          serviceId: rest.serviceId
          pageSize: rest.pageSize
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/runs
      name: reliability-tests-runs
      description: REST surface for reliability-tests-runs.
      operations:
      - method: GET
        name: getallreliabilityruns
        description: Get all reliability test runs ordered by createdDate desc.
        call: gremlin-reliability-tests.getallreliabilityruns
        with:
          serviceId: rest.serviceId
          pageSize: rest.pageSize
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/{reliabilitytestid}
      name: reliability-tests-reliabilitytestid
      description: REST surface for reliability-tests-reliabilityTestId.
      operations:
      - method: GET
        name: getreliabilitytest
        description: Get a single company-scoped reliability test.
        call: gremlin-reliability-tests.getreliabilitytest
        with:
          reliabilityTestId: rest.reliabilityTestId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reliability-tests/{reliabilitytestid}/runs
      name: reliability-tests-reliabilitytestid-runs
      description: REST surface for reliability-tests-reliabilityTestId-runs.
      operations:
      - method: GET
        name: getallreliabilityrunsforreliabilitytest
        description: Get all reliability test runs for a reliabilityTest ordered by createdDate desc.
        call: gremlin-reliability-tests.getallreliabilityrunsforreliabilitytest
        with:
          reliabilityTestId: rest.reliabilityTestId
          serviceId: rest.serviceId
          dependencyId: rest.dependencyId
          failureFlagName: rest.failureFlagName
          pageSize: rest.pageSize
          teamId: rest.teamId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: runreliabilitytestforservice
        description: Run a reliability test for a service.
        call: gremlin-reliability-tests.runreliabilitytestforservice
        with:
          reliabilityTestId: rest.reliabilityTestId
          teamId: rest.teamId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: gremlin-reliability-tests-mcp
    port: 9090
    transport: http
    description: MCP adapter for Gremlin API — reliability-tests. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: get-all-reliability-tests
      description: Get all reliability tests.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getallreliabilitytests
      with:
        teamId: tools.teamId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-active-reliability-tests
      description: Get active reliability tests.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getactivereliabilitytests
      with:
        teamId: tools.teamId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-team-s-active-reliability-tests
      description: Get a team's active reliability tests in descending order by start time.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getpaginatedactivereliabilitytests
      with:
        pageSize: tools.pageSize
        pageToken: tools.pageToken
        teamId: tools.teamId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-team-s-completed-reliability-test
      description: Get a team's completed reliability test runs ordered by start time desc.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getpaginatedcompletedreliabilitytestruns
      with:
        pageSize: tools.pageSize
        pageToken: tools.pageToken
        teamId: tools.teamId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-pending-reliability-test-runs
      description: Get pending reliability test runs for service, ordered by expected trigger time via schedule or Run All.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getpendingservicereliabilityruns
      with:
        serviceId: tools.serviceId
        teamId: tools.teamId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-all-notifications-team
      description: Get all notifications for a team
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getnotificationsforteam
      with:
        sinceDays: tools.sinceDays
        teamId: tools.teamId
      outputParameters:
      - type: object
        mapping: $.
    - name: takes-given-scenario-and-transforms
      description: Takes a given scenario and transforms it for turning into a reliability test
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.previewgraph
      with:
        scenarioType: tools.scenarioType
        scenarioId: tools.scenarioId
        policyCategory: tools.policyCategory
      outputParameters:
      - type: object
        mapping: $.
    - name: get-recently-completed-reliability-test
      description: Get recently completed reliability test runs ordered by endDate desc. for a service
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getrecentreliabilitytestruns
      with:
        serviceId: tools.serviceId
        pageSize: tools.pageSize
        teamId: tools.teamId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-all-reliability-test-runs
      description: Get all reliability test runs ordered by createdDate desc.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getallreliabilityruns
      with:
        serviceId: tools.serviceId
        pageSize: tools.pageSize
        teamId: tools.teamId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-single-company-scoped-reliability
      description: Get a single company-scoped reliability test.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getreliabilitytest
      with:
        reliabilityTestId: tools.reliabilityTestId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-all-reliability-test-runs-2
      description: Get all reliability test runs for a reliabilityTest ordered by createdDate desc.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: gremlin-reliability-tests.getallreliabilityrunsforreliabilitytest
      with:
        reliabilityTestId: tools.reliabilityTestId
        serviceId: tools.serviceId
        dependencyId: tools.dependencyId
        failureFlagName: tools.failureFlagName
        pageSize: tools.pageSize
        teamId: tools.teamId
      outputParameters:
      - type: object
        mapping: $.
    - name: run-reliability-test-service
      description: Run a reliability test for a service.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: gremlin-reliability-tests.runreliabilitytestforservice
      with:
        reliabilityTestId: tools.reliabilityTestId
        teamId: tools.teamId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.