mammoth-io

mammoth-io Resources v2 API

The Resources v2 API from mammoth-io — 5 operation(s) for resources v2.

GitHub OpenAPI

Operations 5

POST /workspaces/{workspace_id}/projects/{project_id}/resources/bulk Bulk get resources #
GET /workspaces/{workspace_id}/projects/{project_id}/resources/{resource_type}/{object_id} Get a single resource #
GET /workspaces/{workspace_id}/projects/{project_id}/resources/ancestors Get the folder path containing a resource #
GET /workspaces/{workspace_id}/projects/{project_id}/resources List resources with pagination #
GET /workspaces/{workspace_id}/resources Search resources across a workspace #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/mammoth-io/openapi/mammoth-io-resources-v2-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-resources-v2-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-resources-v2-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mammoth Io Resources v2 API
  version: 0.1.0
  contact:
    name: Mammoth Analytics
    url: https://mammoth.io
    email: support@mammoth.io
  description: 'Operations tagged Resources v2 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: Resources v2
paths:
  /workspaces/{workspace_id}/projects/{project_id}/resources/bulk:
    post:
      tags:
      - Resources v2
      summary: Bulk get resources
      description: Fetch multiple resources by type and ID.
      operationId: BulkGetResources
      parameters:
      - name: workspace_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      - name: project_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkResourceRequest'
        required: true
      responses:
        '201':
          description: Document created, URL follows
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkResourcesResponse'
        '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}/resources/{resource_type}/{object_id}:
    get:
      tags:
      - Resources v2
      summary: Get a single resource
      description: Fetch a resource by type and ID with full properties.
      operationId: GetResource
      parameters:
      - name: workspace_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      - name: project_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      - name: resource_type
        in: path
        schema:
          type: string
        required: true
        deprecated: false
      - name: object_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      responses:
        '200':
          description: Request fulfilled, document follows
          headers: {}
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/ResourceDetailResponse'
                - type: 'null'
        '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}/resources/ancestors:
    get:
      tags:
      - Resources v2
      summary: Get the folder path containing a resource
      description: Return the folder chain that contains a resource, root first, given only its resource id. A deep link into a nested folder knows just that id, and the list endpoint cannot answer it — a folder's own row lives in its parent's page — so this is what lets the breadcrumb and page title resolve on a cold load.
      operationId: GetResourceAncestors
      parameters:
      - name: project_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      - name: resource_id
        in: query
        schema:
          type: integer
        required: true
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: workspace_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      responses:
        '200':
          description: Request fulfilled, document follows
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkResourcesResponse'
        '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}/resources:
    get:
      tags:
      - Resources v2
      summary: List resources with pagination
      description: Browse resources within a project scope with cursor-based pagination.
      operationId: ListResources
      parameters:
      - name: workspace_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      - name: project_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      - name: parent_type
        in: query
        schema:
          oneOf:
          - type: string
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: parent_id
        in: query
        schema:
          oneOf:
          - type: integer
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: type
        in: query
        schema:
          oneOf:
          - type: string
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: search
        in: query
        schema:
          oneOf:
          - type: string
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: cursor
        in: query
        schema:
          oneOf:
          - type: string
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: limit
        in: query
        schema:
          type: integer
          default: 50
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: sort
        in: query
        schema:
          oneOf:
          - type: string
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: fields
        in: query
        schema:
          type: string
          default: standard
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      responses:
        '200':
          description: Request fulfilled, document follows
          headers: {}
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/PaginatedResourcesResponse'
                - type: 'null'
        '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}/resources:
    get:
      tags:
      - Resources v2
      summary: Search resources across a workspace
      description: Search resources across every project the user can access in the workspace. Used by the global search bar for cross-project results.
      operationId: SearchResources
      parameters:
      - name: workspace_id
        in: path
        schema:
          type: integer
        required: true
        deprecated: false
      - name: type
        in: query
        schema:
          oneOf:
          - type: string
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: search
        in: query
        schema:
          oneOf:
          - type: string
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: cursor
        in: query
        schema:
          oneOf:
          - type: string
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: limit
        in: query
        schema:
          type: integer
          default: 50
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: sort
        in: query
        schema:
          oneOf:
          - type: string
          - type: 'null'
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      - name: fields
        in: query
        schema:
          type: string
          default: standard
        required: false
        deprecated: false
        allowEmptyValue: false
        allowReserved: false
      responses:
        '200':
          description: Request fulfilled, document follows
          headers: {}
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/PaginatedResourcesResponse'
                - type: 'null'
        '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
components:
  schemas:
    PaginatedResourcesResponse:
      properties:
        resources:
          items:
            $ref: '#/components/schemas/ResourceItemResponse'
          type: array
        next_cursor:
          oneOf:
          - type: string
          - type: 'null'
        has_more:
          type: boolean
      type: object
      required:
      - has_more
      - resources
      title: PaginatedResourcesResponse
    ResourceItemResponse:
      properties:
        id:
          type: integer
        resource_type:
          type: string
        object_id:
          type: integer
        resource_id:
          oneOf:
          - type: integer
          - type: 'null'
        name:
          oneOf:
          - type: string
          - type: 'null'
        project_id:
          oneOf:
          - type: integer
          - type: 'null'
        parent_resource_id:
          oneOf:
          - type: integer
          - type: 'null'
        source_type:
          oneOf:
          - type: string
          - type: 'null'
        row_count:
          oneOf:
          - type: integer
          - type: 'null'
        column_count:
          oneOf:
          - type: integer
          - type: 'null'
        created_at:
          oneOf:
          - type: string
          - type: 'null'
        last_updated_at:
          oneOf:
          - type: string
          - type: 'null'
        status:
          oneOf:
          - type: string
          - type: 'null'
        data_size:
          oneOf:
          - type: integer
          - type: 'null'
        etag:
          oneOf:
          - type: string
          - type: 'null'
        integration_key:
          oneOf:
          - type: string
          - type: 'null'
        additional_data:
          oneOf:
          - additionalProperties: {}
            type: object
          - type: 'null'
        additional_info:
          oneOf:
          - additionalProperties: {}
            type: object
          - type: 'null'
        config_keys:
          oneOf:
          - additionalProperties: {}
            type: object
          - type: 'null'
        display_info:
          oneOf:
          - additionalProperties: {}
            type: object
          - type: 'null'
        dependencies:
          oneOf:
          - additionalProperties: {}
            type: object
          - type: 'null'
        views_ids:
          oneOf:
          - items:
              type: object
            type: array
          - type: 'null'
        dataset:
          oneOf:
          - additionalProperties: {}
            type: object
          - type: 'null'
        target_resource_ids:
          oneOf:
          - items:
              type: integer
            type: array
          - type: 'null'
        files_count:
          oneOf:
          - type: integer
          - type: 'null'
        folders_count:
          oneOf:
          - type: integer
          - type: 'null'
        object_properties:
          oneOf:
          - additionalProperties: {}
            type: object
          - type: 'null'
        has_linked_ops:
          oneOf:
          - type: boolean
          - type: 'null'
        linked_dashboards:
          oneOf:
          - items:
              type: object
            type: array
          - type: 'null'
      type: object
      required:
      - id
      - object_id
      - resource_type
      title: ResourceItemResponse
    BulkResourcesResponse:
      properties:
        resources:
          items:
            $ref: '#/components/schemas/ResourceItemResponse'
          type: array
      type: object
      required:
      - resources
      title: BulkResourcesResponse
    ResourceDetailResponse:
      properties:
        resource:
          $ref: '#/components/schemas/ResourceItemResponse'
      type: object
      required:
      - resource
      title: ResourceDetailResponse
    BulkResourceRequest:
      properties:
        ids:
          items:
            $ref: '#/components/schemas/BulkResourceId'
          type: array
      type: object
      required:
      - ids
      title: BulkResourceRequest
    BulkResourceId:
      properties:
        type:
          type: string
          minLength: 1
        id:
          type: integer
          minimum: 1.0
      type: object
      required:
      - id
      - type
      title: BulkResourceId
  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