# mammoth-io Agents API

**Canonical:** https://apis.io/apis/mammoth-io/mammoth-io-agents-api/  
**Provider:** mammoth-io — https://apis.io/providers/mammoth-io/  
**Base URL:** https://app.mammoth.io/api/v2  
**Documentation:** https://docs.mammoth.io/

mammoth-io Agents API is one of 114 APIs that [mammoth-io](https://apis.io/providers/mammoth-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Agents API from mammoth-io — 105 operation(s) for agents.

## Operations (60 of 123)

| Method | Path | Summary |
|---|---|---|
| POST | `/agents/sessions/{session_id}/turns/{turn_id}/cancel` | Stop one agent turn (session owner only) |
| POST | `/agents/chat` | Chat with a Mammoth agent |
| PATCH | `/agents/sessions/{session_id}/messages/{message_id}/request-kind` | Correct what kind of request a reply answered (creator only) |
| DELETE | `/agents/sessions/{session_id}` | Delete an agent chat session |
| PATCH | `/agents/sessions/{session_id}` | Rename, share or move a chat (creator only), or pin it for yourself (anyone who… |
| DELETE | `/agents/sessions/{session_id}/actions/{action_id}` | Delete an object the agent created in a chat (session owner only) |
| POST | `/agents/sessions/{session_id}/needs-you/dismiss` | Dismiss what a chat waits on its owner for (creator only) |
| PATCH | `/agents/sessions/{session_id}/plan/proposal` | Edit the plan's waiting workflow proposal (creator only) |
| POST | `/agents/sessions/{session_id}/runs/{run_id}/extend` | Raise a capped run's budget and continue it (session owner only) |
| GET | `/agents/briefing` | What changed in the user's data since their last visit to the agent home |
| GET | `/agents/documents/{sha}` | What a document shared in this workspace's chats is |
| GET | `/agents/documents/{sha}/pages/{page}` | One page of a shared document, as a PNG |
| GET | `/agents/images/{sha}` | A picture shared in this workspace's chats |
| GET | `/agents/sessions/{session_id}/runs/{run_id}/instances/{instance_id}/messages` | The messages an agent of a run sent or received |
| GET | `/agents/sessions/{session_id}/runs/{run_id}/instances/{instance_id}/transcript` | The model messages of an agent of a run, credentials redacted |
| GET | `/agents/sessions/{session_id}/feedback` | List the ratings the creator gave one chat's replies |
| GET | `/agents/needs-you` | The caller's chats that wait on them, in every project |
| POST | `/agents/sessions/{session_id}/seen` | Mark a chat as seen by its owner (creator only) |
| POST | `/agents/sessions/{session_id}/notify-job` | Notify connector agent of an async connection job result |
| POST | `/agents/sessions/{session_id}/runs/{run_id}/pause` | Pause a run (session owner only) |
| POST | `/agents/sessions/{session_id}/turns/{turn_id}/feedback` | Rate one agent reply (creator only) |
| POST | `/agents/sessions/{session_id}/chart-placements` | Record a chat chart the owner put on a dashboard (creator only) |
| POST | `/agents/sessions/{session_id}/chip-feedback` | Remember a click or dismiss of a follow-up chip (creator only) |
| GET | `/agents/sessions/{session_id}/runs/{run_id}/units` | The units of work a run's steps do, one page at a time |
| POST | `/agents/sessions/{session_id}/runs/{run_id}/units` | Report the units a plan step will work on (session owner only) |
| POST | `/agents/sessions/{session_id}/runs/{run_id}/resume` | Resume a paused run on a fresh time budget (session owner only) |
| POST | `/agents/sessions/{session_id}/runs/{run_id}/retry` | Retry a failed or stopped run as a new run (session owner only) |
| GET | `/agents/sessions/{session_id}/runs/{run_id}/instances` | The agents of a run: main and its workers |
| GET | `/agents/sessions/{session_id}/actions` | List what the agent changed in one chat |
| GET | `/agents/sessions/{session_id}/messages` | Read messages for one agent session |
| GET | `/agents/sessions/{session_id}/run` | The chat's current run |
| GET | `/agents/sessions/{session_id}/runs` | The chat's runs, newest first |
| GET | `/agents/sessions` | List current user's agent sessions |
| POST | `/agents/sessions/{session_id}/runs/{run_id}/stop` | Stop a run and cancel its live turn (session owner only) |
| POST | `/agents/sessions/{session_id}/credential-test` | Test what a chat's credential card typed, before saving (owner only) |
| GET | `/agents/sessions/{session_id}/turns/{turn_id}/events` | Watch one agent turn's events |
| POST | `/agents/documents` | Keep a PDF, Word or PowerPoint file the user shares in a chat |
| POST | `/agents/images` | Keep a picture the user shares in a chat |
| GET | `/agents/access/me` | What the agent may do for the caller in this workspace |
| GET | `/agents/access/reach` | What one person's agent can see |
| GET | `/agents/access/tree` | The projects and files the Give access tree offers (managers only) |
| GET | `/agents/access/welcome` | What the caller was given and what they start with |
| DELETE | `/agents/access/grants/{grant_id}` | Revoke a person's access (managers only) |
| PATCH | `/agents/access/grants/{grant_id}` | Change a person's access (managers only) |
| POST | `/agents/access/grants/welcome-draft` | Draft what an invited person sees first (managers only) |
| GET | `/agents/access/settings/usage` | This month's Ask use: guests' questions and how fast answers come |
| GET | `/agents/access/settings` | The workspace's AI Agent controls (managers only) |
| PATCH | `/agents/access/settings` | Change the workspace's AI Agent controls (managers only) |
| GET | `/agents/access/grants` | Who can ask without opening the data (managers only) |
| POST | `/agents/access/grants` | Give people access to ask about projects (managers only) |
| GET | `/agents/access/people` | Everyone else: members and what their own access gives their agent |
| POST | `/agents/access/first-visit/prepare` | Prepare the caller's first visit to Ask in the background |
| GET | `/agents/access/projects/{project_id}/askers` | How many people can ask about a project without opening it |
| POST | `/agents/access/grants/{grant_id}/send-invite` | Send a held invite now, before the person's first visit is ready |
| POST | `/agents/access/my-agent/tiles/{prepared_id}` | Add a prepared answer as a tile on the caller's Ask home |
| POST | `/agents/access/my-agent/tiles/verified/{verified_id}` | Add a verified answer as a tile, run on the caller's own data |
| POST | `/agents/access/offers/{fact_id}` | Keep what the agent noticed on top of Today, or not now |
| GET | `/agents/access/alerts` | The caller's alerts, newest first, each with its table's name |
| POST | `/agents/access/alerts` | Keep an alert: checked each time its table refreshes |
| PUT | `/agents/access/alerts/{alert_id}` | Change an alert's intent, condition, name or where it tells the caller |

…and 63 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/mammoth-io/openapi/mammoth-io-agents-api-openapi.yml
- **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

## Other mammoth-io APIs (12)

- [mammoth-io Accept Invite API](https://apis.io/apis/mammoth-io/mammoth-io-accept-invite-api/)
- [mammoth-io Activity Logs API](https://apis.io/apis/mammoth-io/mammoth-io-activity-logs-api/)
- [mammoth-io Admin Home Support API](https://apis.io/apis/mammoth-io/mammoth-io-admin-home-support-api/)
- [mammoth-io Agent access API](https://apis.io/apis/mammoth-io/mammoth-io-agent-access-api/)
- [mammoth-io Agent email API](https://apis.io/apis/mammoth-io/mammoth-io-agent-email-api/)
- [mammoth-io AI API](https://apis.io/apis/mammoth-io/mammoth-io-ai-api/)
- [mammoth-io Annotations API](https://apis.io/apis/mammoth-io/mammoth-io-annotations-api/)
- [mammoth-io App Usage API](https://apis.io/apis/mammoth-io/mammoth-io-app-usage-api/)
- [mammoth-io Automations API](https://apis.io/apis/mammoth-io/mammoth-io-automations-api/)
- [mammoth-io Batches API](https://apis.io/apis/mammoth-io/mammoth-io-batches-api/)
- [mammoth-io Billing Actions Support API](https://apis.io/apis/mammoth-io/mammoth-io-billing-actions-support-api/)
- [mammoth-io Browse API](https://apis.io/apis/mammoth-io/mammoth-io-browse-api/)

## Tags

Agents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/mammoth-io/mammoth-io-agents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/mammoth-io/.