mammoth-io

mammoth-io Dataview analysis API

The Dataview analysis API from mammoth-io — 2 operation(s) for dataview analysis.

GitHub OpenAPI

Operations 2

GET /workspaces/{workspace_id}/projects/{project_id}/datasets/{dataset_id}/dataviews/{dataview_id}/analysis Analyze a dataview pipeline #
POST /workspaces/{workspace_id}/projects/{project_id}/datasets/{dataset_id}/dataviews/{dataview_id}/optimize Optimize a dataview pipeline #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/mammoth-io/openapi/mammoth-io-dataview-analysis-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/mammoth-io/json-schema/mammoth-io-workspace-create-schema.json
📊
JSONSchema
https://artifacts.apis.io/mammoth-io/json-schema/mammoth-io-datasets-list-schema.json
📊
JSONSchema
https://artifacts.apis.io/mammoth-io/json-schema/mammoth-io-activity-filters-schema-schema.json
📊
JSONSchema
https://artifacts.apis.io/mammoth-io/json-schema/mammoth-io-automation-creation-schema-schema.json
📊
JSONSchema
https://artifacts.apis.io/mammoth-io/json-schema/mammoth-io-dataview-info-schema.json
📊
JSONSchema
https://artifacts.apis.io/mammoth-io/json-schema/mammoth-io-update-plan-request-schema-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mammoth-io:mammoth-io-dataview-analysis-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mammoth-io-dataview-analysis-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mammoth Io Dataview analysis API
  version: 0.1.0
  contact:
    name: Mammoth Analytics
    url: https://mammoth.io
    email: support@mammoth.io
  description: 'Operations tagged Dataview analysis across 2 of this provider''s published API definitions: app.mammoth.io-openapi.json, mammoth-io-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /api/v2
security:
- bearerAuth: []
- apiKey: []
  apiSecret: []
  workspaceId: []
tags:
- name: Dataview analysis
paths:
  /workspaces/{workspace_id}/projects/{project_id}/datasets/{dataset_id}/dataviews/{dataview_id}/analysis:
    get:
      tags:
      - Dataview analysis
      summary: Analyze a dataview pipeline
      description: Read-only. Lists steps that can be dropped or moved without changing the result. Each finding says whether it is provably safe.
      operationId: GetAnalysis
      parameters:
      - name: workspace_id
        in: path
        schema:
          type: integer
          minimum: 1.0
          title: Workspace ID
          description: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.
          examples:
          - 4
        description: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.
        required: true
        deprecated: false
        examples:
          workspace_id-example-1:
            summary: Sample workspace ID
            value: 4
      - name: project_id
        in: path
        schema:
          type: integer
          minimum: 1.0
          title: Project ID
          description: Project ID of the workspace
          examples:
          - 4
        description: Project ID of the workspace
        required: true
        deprecated: false
        examples:
          project_id-example-1:
            summary: Sample project ID
            value: 4
      - name: dataset_id
        in: path
        schema:
          type: integer
          minimum: 0.0
          title: Dataset ID
          description: Id of the dataset
          examples:
          - 121
        description: Id of the dataset
        required: true
        deprecated: false
        examples:
          dataset_id-example-1:
            summary: Sample dataset ID
            value: 121
      - name: dataview_id
        in: path
        schema:
          type: integer
          minimum: 1.0
          title: Dataview ID
          description: Dataview ID of the dataset
          examples:
          - 4
        description: Dataview ID of the dataset
        required: true
        deprecated: false
        examples:
          dataview_id-example-1:
            summary: Sample dataview ID
            value: 4
      responses:
        '200':
          description: Request fulfilled, document follows
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalysisResponse'
        '403':
          description: Request forbidden -- authorization will not help
          content:
            application/json:
              schema:
                properties:
                  status_code:
                    type: integer
                  detail:
                    type: string
                  extra:
                    additionalProperties: {}
                    type:
                    - 'null'
                    - object
                    - array
                type: object
                required:
                - detail
                - status_code
                description: Authorization Exception
                examples:
                - status_code: 403
                  detail: Forbidden
                  extra: {}
        '404':
          description: Nothing matches the given URI
          content:
            application/json:
              schema:
                properties:
                  status_code:
                    type: integer
                  detail:
                    type: string
                  extra:
                    additionalProperties: {}
                    type:
                    - 'null'
                    - object
                    - array
                type: object
                required:
                - detail
                - status_code
                description: Not Found Exception
                examples:
                - status_code: 404
                  detail: Not Found
                  extra: {}
        '400':
          description: Bad request syntax or unsupported method
          content:
            application/json:
              schema:
                properties:
                  status_code:
                    type: integer
                  detail:
                    type: string
                  extra:
                    additionalProperties: {}
                    type:
                    - 'null'
                    - object
                    - array
                type: object
                required:
                - detail
                - status_code
                description: Validation Exception
                examples:
                - status_code: 400
                  detail: Bad Request
                  extra: {}
      deprecated: false
    servers:
    - url: /api/v2
  /workspaces/{workspace_id}/projects/{project_id}/datasets/{dataset_id}/dataviews/{dataview_id}/optimize:
    post:
      tags:
      - Dataview analysis
      summary: Optimize a dataview pipeline
      description: Applies only the safe findings (optionally limited to apply_rules) through the pipeline reorder and discard paths, which validate and rerun the pipeline.
      operationId: OptimizePipeline
      parameters:
      - name: workspace_id
        in: path
        schema:
          type: integer
          minimum: 1.0
          title: Workspace ID
          description: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.
          examples:
          - 4
        description: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.
        required: true
        deprecated: false
        examples:
          workspace_id-example-1:
            summary: Sample workspace ID
            value: 4
      - name: project_id
        in: path
        schema:
          type: integer
          minimum: 1.0
          title: Project ID
          description: Project ID of the workspace
          examples:
          - 4
        description: Project ID of the workspace
        required: true
        deprecated: false
        examples:
          project_id-example-1:
            summary: Sample project ID
            value: 4
      - name: dataset_id
        in: path
        schema:
          type: integer
          minimum: 0.0
          title: Dataset ID
          description: Id of the dataset
          examples:
          - 121
        description: Id of the dataset
        required: true
        deprecated: false
        examples:
          dataset_id-example-1:
            summary: Sample dataset ID
            value: 121
      - name: dataview_id
        in: path
        schema:
          type: integer
          minimum: 1.0
          title: Dataview ID
          description: Dataview ID of the dataset
          examples:
          - 4
        description: Dataview ID of the dataset
        required: true
        deprecated: false
        examples:
          dataview_id-example-1:
            summary: Sample dataview ID
            value: 4
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/OptimizeRequest'
              - type: 'null'
        required: true
      responses:
        '200':
          description: Request fulfilled, document follows
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OptimizeResponse'
        '400':
          description: Bad request syntax or unsupported method
          content:
            application/json:
              schema:
                oneOf:
                - properties:
                    status_code:
                      type: integer
                    detail:
                      type: string
                    extra:
                      additionalProperties: {}
                      type:
                      - 'null'
                      - object
                      - array
                  type: object
                  required:
                  - detail
                  - status_code
                  description: Client Error
                  examples:
                  - status_code: 400
                    detail: Bad Request
                    extra: {}
                - properties:
                    status_code:
                      type: integer
                    detail:
                      type: string
                    extra:
                      additionalProperties: {}
                      type:
                      - 'null'
                      - object
                      - array
                  type: object
                  required:
                  - detail
                  - status_code
                  description: Validation Exception
                  examples:
                  - status_code: 400
                    detail: Bad Request
                    extra: {}
        '403':
          description: Request forbidden -- authorization will not help
          content:
            application/json:
              schema:
                properties:
                  status_code:
                    type: integer
                  detail:
                    type: string
                  extra:
                    additionalProperties: {}
                    type:
                    - 'null'
                    - object
                    - array
                type: object
                required:
                - detail
                - status_code
                description: Authorization Exception
                examples:
                - status_code: 403
                  detail: Forbidden
                  extra: {}
        '404':
          description: Nothing matches the given URI
          content:
            application/json:
              schema:
                properties:
                  status_code:
                    type: integer
                  detail:
                    type: string
                  extra:
                    additionalProperties: {}
                    type:
                    - 'null'
                    - object
                    - array
                type: object
                required:
                - detail
                - status_code
                description: Not Found Exception
                examples:
                - status_code: 404
                  detail: Not Found
                  extra: {}
      deprecated: false
    servers:
    - url: /api/v2
components:
  schemas:
    OptimizeResponse:
      properties:
        applied:
          items:
            $ref: '#/components/schemas/Finding'
          type: array
        skipped:
          items:
            $ref: '#/components/schemas/SkippedFinding'
          type: array
        before_steps:
          type: integer
          title: Steps that ran before the optimize
        after_steps:
          type: integer
          title: Steps that run after the optimize
        job_id:
          oneOf:
          - type: integer
          - type: 'null'
          title: Background job the rerun is tracked by
      type: object
      required:
      - after_steps
      - applied
      - before_steps
      - skipped
      title: OptimizeResponse
    OptimizeRequest:
      properties:
        apply_rules:
          oneOf:
          - items:
              $ref: '#/components/schemas/OptimizeRule'
            type: array
          - type: 'null'
          title: Rules to apply; null applies every safe finding
      type: object
      required: []
      title: OptimizeRequest
    SkippedFinding:
      properties:
        rule:
          $ref: '#/components/schemas/OptimizeRule'
        seqs:
          items:
            type: integer
          type: array
        reason:
          type: string
      type: object
      required:
      - reason
      - rule
      - seqs
      title: SkippedFinding
    Finding:
      properties:
        rule:
          $ref: '#/components/schemas/OptimizeRule'
        seqs:
          items:
            type: integer
          type: array
          title: Pipeline step sequences the finding is about
        detail:
          type: string
          title: Why the finding holds
        proposed_order:
          oneOf:
          - items:
              type: integer
            type: array
          - type: 'null'
          title: Full step order (current sequences) after the change; reorders only
        safe:
          type: boolean
          title: True only when the change provably preserves results
      type: object
      required:
      - detail
      - rule
      - safe
      - seqs
      title: Finding
    AnalysisResponse:
      properties:
        findings:
          items:
            $ref: '#/components/schemas/Finding'
          type: array
      type: object
      required:
      - findings
      title: AnalysisResponse
    OptimizeRule:
      type: string
      enum:
      - drop_suspended
      - drop_duplicate
      - drop_noop_filter
      - hoist_filter
      title: OptimizeRule
  securitySchemes:
    bearerAuth:
      type: http
      description: 'Primary credential. Authorization: Bearer mm_<token>. The token is issued server-side and shown once at creation.'
      scheme: bearer
    apiKey:
      type: apiKey
      description: Deprecated — use bearerAuth.
      name: X-API-KEY
      in: header
    apiSecret:
      type: apiKey
      description: Deprecated — use bearerAuth.
      name: X-API-SECRET
      in: header
    workspaceId:
      type: apiKey
      description: Required with X-API-KEY and X-API-SECRET. Deprecated with them — use bearerAuth.
      name: X-WORKSPACE-ID
      in: header
x-refined-from:
- app.mammoth.io-openapi.json
- mammoth-io-openapi.json