mammoth-io Resources v2 API
The Resources v2 API from mammoth-io — 5 operation(s) for resources v2.
The Resources v2 API from mammoth-io — 5 operation(s) for resources v2.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mammoth-io:mammoth-io-resources-v2-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
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