Sumo Logic API — spanAnalytics

naftiko: 1.0.0-alpha2
info:
  label: Sumo Logic API — spanAnalytics
  description: 'Sumo Logic API — spanAnalytics. 10 operations. Lead operation: Run A Span Analytics Query Asynchronously..
    Self-contained Naftiko capability covering one Sumo Logic business surface.'
  tags:
  - Sumo Logic
  - spanAnalytics
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SUMO_LOGIC_API_KEY: SUMO_LOGIC_API_KEY
capability:
  consumes:
  - type: http
    namespace: sumo-logic-spananalytics
    baseUri: https://api.au.sumologic.com/api
    description: Sumo Logic API — spanAnalytics business capability. Self-contained, no shared references.
    resources:
    - name: v1-tracing-spanquery
      path: /v1/tracing/spanquery
      operations:
      - name: createspanquery
        method: POST
        description: Run A Span Analytics Query Asynchronously.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-tracing-spanquery-fields
      path: /v1/tracing/spanquery/fields
      operations:
      - name: getspanqueryfields
        method: GET
        description: Get Filter Fields For Span Analytics Queries.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-tracing-spanquery-fields-field-values
      path: /v1/tracing/spanquery/fields/{field}/values
      operations:
      - name: getspanqueryfieldvalues
        method: GET
        description: Get Span Analytics Query Filter Field Values.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: field
          in: path
          type: string
          description: Field identifier.
          required: true
        - name: query
          in: query
          type: string
          description: Search filter to apply on the values to be returned. Only values containing the search query term will
            be returned.
        - name: limit
          in: query
          type: integer
          description: The maximum number of results to fetch.
        - name: token
          in: query
          type: string
          description: Continuation token to get the next page of results. A page object with the next continuation token
            is returned in the response body. Subsequent GET requests sho
    - name: v1-tracing-spanquery-queryId
      path: /v1/tracing/spanquery/{queryId}
      operations:
      - name: cancelspanquery
        method: DELETE
        description: Cancel A Span Analytics Query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: queryId
          in: path
          type: string
          description: Identifier of the query to cancel.
          required: true
    - name: v1-tracing-spanquery-queryId-aggregates
      path: /v1/tracing/spanquery/{queryId}/aggregates
      operations:
      - name: getspanqueryaggregates
        method: GET
        description: Get Span Analytics Query Aggregated Results.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: queryId
          in: path
          type: string
          description: Identifier of the executed query.
          required: true
    - name: v1-tracing-spanquery-queryId-pause
      path: /v1/tracing/spanquery/{queryId}/pause
      operations:
      - name: pausespanquery
        method: PUT
        description: Pause A Span Analytics Query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: queryId
          in: path
          type: string
          description: Identifier of the query to pause.
          required: true
    - name: v1-tracing-spanquery-queryId-resume
      path: /v1/tracing/spanquery/{queryId}/resume
      operations:
      - name: resumespanquery
        method: PUT
        description: Resume A Span Analytics Query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: queryId
          in: path
          type: string
          description: Identifier of the query to resume.
          required: true
    - name: v1-tracing-spanquery-queryId-rows-rowId-facets
      path: /v1/tracing/spanquery/{queryId}/rows/{rowId}/facets
      operations:
      - name: getspanqueryfacets
        method: GET
        description: Get A List Of Facets Of A Span Analytics Query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: queryId
          in: path
          type: string
          description: Identifier of the executed query.
          required: true
        - name: rowId
          in: path
          type: string
          description: Identifier of the query row.
          required: true
    - name: v1-tracing-spanquery-queryId-rows-rowId-spans
      path: /v1/tracing/spanquery/{queryId}/rows/{rowId}/spans
      operations:
      - name: getspanqueryresult
        method: GET
        description: Get Results Of A Span Analytics Query.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: queryId
          in: path
          type: string
          description: Identifier of the executed query.
          required: true
        - name: rowId
          in: path
          type: string
          description: Identifier of the query row.
          required: true
        - name: limit
          in: query
          type: integer
          description: Limit of the number of spans returned in the response.
        - name: token
          in: query
          type: string
          description: Continuation token to get the next page of results. A page object with the next continuation token
            is returned in the response body. Subsequent GET requests sho
    - name: v1-tracing-spanquery-queryId-status
      path: /v1/tracing/spanquery/{queryId}/status
      operations:
      - name: getspanquerystatus
        method: GET
        description: Get A Span Analytics Query Status.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: queryId
          in: path
          type: string
          description: Identifier of the executed query.
          required: true
    authentication:
      type: basic
      username: '{{env.SUMO_LOGIC_USER}}'
      password: '{{env.SUMO_LOGIC_PASS}}'
  exposes:
  - type: rest
    namespace: sumo-logic-spananalytics-rest
    port: 8080
    description: REST adapter for Sumo Logic API — spanAnalytics. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/tracing/spanquery
      name: v1-tracing-spanquery
      description: REST surface for v1-tracing-spanquery.
      operations:
      - method: POST
        name: createspanquery
        description: Run A Span Analytics Query Asynchronously.
        call: sumo-logic-spananalytics.createspanquery
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/tracing/spanquery/fields
      name: v1-tracing-spanquery-fields
      description: REST surface for v1-tracing-spanquery-fields.
      operations:
      - method: GET
        name: getspanqueryfields
        description: Get Filter Fields For Span Analytics Queries.
        call: sumo-logic-spananalytics.getspanqueryfields
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/tracing/spanquery/fields/{field}/values
      name: v1-tracing-spanquery-fields-field-values
      description: REST surface for v1-tracing-spanquery-fields-field-values.
      operations:
      - method: GET
        name: getspanqueryfieldvalues
        description: Get Span Analytics Query Filter Field Values.
        call: sumo-logic-spananalytics.getspanqueryfieldvalues
        with:
          field: rest.field
          query: rest.query
          limit: rest.limit
          token: rest.token
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/tracing/spanquery/{queryid}
      name: v1-tracing-spanquery-queryid
      description: REST surface for v1-tracing-spanquery-queryId.
      operations:
      - method: DELETE
        name: cancelspanquery
        description: Cancel A Span Analytics Query.
        call: sumo-logic-spananalytics.cancelspanquery
        with:
          queryId: rest.queryId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/tracing/spanquery/{queryid}/aggregates
      name: v1-tracing-spanquery-queryid-aggregates
      description: REST surface for v1-tracing-spanquery-queryId-aggregates.
      operations:
      - method: GET
        name: getspanqueryaggregates
        description: Get Span Analytics Query Aggregated Results.
        call: sumo-logic-spananalytics.getspanqueryaggregates
        with:
          queryId: rest.queryId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/tracing/spanquery/{queryid}/pause
      name: v1-tracing-spanquery-queryid-pause
      description: REST surface for v1-tracing-spanquery-queryId-pause.
      operations:
      - method: PUT
        name: pausespanquery
        description: Pause A Span Analytics Query.
        call: sumo-logic-spananalytics.pausespanquery
        with:
          queryId: rest.queryId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/tracing/spanquery/{queryid}/resume
      name: v1-tracing-spanquery-queryid-resume
      description: REST surface for v1-tracing-spanquery-queryId-resume.
      operations:
      - method: PUT
        name: resumespanquery
        description: Resume A Span Analytics Query.
        call: sumo-logic-spananalytics.resumespanquery
        with:
          queryId: rest.queryId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/tracing/spanquery/{queryid}/rows/{rowid}/facets
      name: v1-tracing-spanquery-queryid-rows-rowid-facets
      description: REST surface for v1-tracing-spanquery-queryId-rows-rowId-facets.
      operations:
      - method: GET
        name: getspanqueryfacets
        description: Get A List Of Facets Of A Span Analytics Query.
        call: sumo-logic-spananalytics.getspanqueryfacets
        with:
          queryId: rest.queryId
          rowId: rest.rowId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/tracing/spanquery/{queryid}/rows/{rowid}/spans
      name: v1-tracing-spanquery-queryid-rows-rowid-spans
      description: REST surface for v1-tracing-spanquery-queryId-rows-rowId-spans.
      operations:
      - method: GET
        name: getspanqueryresult
        description: Get Results Of A Span Analytics Query.
        call: sumo-logic-spananalytics.getspanqueryresult
        with:
          queryId: rest.queryId
          rowId: rest.rowId
          limit: rest.limit
          token: rest.token
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/tracing/spanquery/{queryid}/status
      name: v1-tracing-spanquery-queryid-status
      description: REST surface for v1-tracing-spanquery-queryId-status.
      operations:
      - method: GET
        name: getspanquerystatus
        description: Get A Span Analytics Query Status.
        call: sumo-logic-spananalytics.getspanquerystatus
        with:
          queryId: rest.queryId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: sumo-logic-spananalytics-mcp
    port: 9090
    transport: http
    description: MCP adapter for Sumo Logic API — spanAnalytics. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: run-span-analytics-query-asynchronously
      description: Run A Span Analytics Query Asynchronously.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: sumo-logic-spananalytics.createspanquery
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-filter-fields-span-analytics
      description: Get Filter Fields For Span Analytics Queries.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-spananalytics.getspanqueryfields
      outputParameters:
      - type: object
        mapping: $.
    - name: get-span-analytics-query-filter
      description: Get Span Analytics Query Filter Field Values.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-spananalytics.getspanqueryfieldvalues
      with:
        field: tools.field
        query: tools.query
        limit: tools.limit
        token: tools.token
      outputParameters:
      - type: object
        mapping: $.
    - name: cancel-span-analytics-query
      description: Cancel A Span Analytics Query.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: sumo-logic-spananalytics.cancelspanquery
      with:
        queryId: tools.queryId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-span-analytics-query-aggregated
      description: Get Span Analytics Query Aggregated Results.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-spananalytics.getspanqueryaggregates
      with:
        queryId: tools.queryId
      outputParameters:
      - type: object
        mapping: $.
    - name: pause-span-analytics-query
      description: Pause A Span Analytics Query.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: sumo-logic-spananalytics.pausespanquery
      with:
        queryId: tools.queryId
      outputParameters:
      - type: object
        mapping: $.
    - name: resume-span-analytics-query
      description: Resume A Span Analytics Query.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: sumo-logic-spananalytics.resumespanquery
      with:
        queryId: tools.queryId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-facets-span-analytics
      description: Get A List Of Facets Of A Span Analytics Query.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-spananalytics.getspanqueryfacets
      with:
        queryId: tools.queryId
        rowId: tools.rowId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-results-span-analytics-query
      description: Get Results Of A Span Analytics Query.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-spananalytics.getspanqueryresult
      with:
        queryId: tools.queryId
        rowId: tools.rowId
        limit: tools.limit
        token: tools.token
      outputParameters:
      - type: object
        mapping: $.
    - name: get-span-analytics-query-status
      description: Get A Span Analytics Query Status.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: sumo-logic-spananalytics.getspanquerystatus
      with:
        queryId: tools.queryId
      outputParameters:
      - type: object
        mapping: $.