---
title: "Ask for access or a change, or flag an answer, from the chat"
method: POST
path: "/agents/access/requests"
tags: ["AI", "Agent access"]
---

# Ask for access or a change, or flag an answer, from the chat

`POST /agents/access/requests`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/agents/access/requests`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Any member. The same person asking the same thing of the same turn again gets the open request back. An access or change request tells the workspace's owners and admins (and a change, the file's keeper).

## Request body

- CreateAgentRequest
  - `kind` 'access' | 'change' | 'feedback', required
  - `project_id` integer, nullable
  - `file_id` integer, nullable
  - `asked` string, nullable
  - `text` string, required
  - `session_id` string, nullable
  - `turn_id` string, nullable
  - `dashboard_id` integer, nullable

## Response `201`

Document created, URL follows

- AgentRequestItem
  - `id` integer, required
  - `kind` 'access' | 'change' | 'feedback', required
  - `requester` PersonRef, required
    - `id` integer, required
    - `name` string, required
  - `project_id` integer, nullable
  - `project_name` string, nullable
  - `file_id` integer, nullable
  - `file_name` string, nullable
  - `owners` PersonRef[]
    - `id` integer, required
    - `name` string, required
  - `asked` string, nullable
  - `text` string, required
  - `session_id` string, nullable
  - `turn_id` string, nullable
  - `status` string, required
  - `created_at` string, date-time, required
  - `resolved_at` string, date-time, nullable
  - `resolved_by` PersonRef
    - `id` integer, required
    - `name` string, required
  - `keeper` PersonRef
    - `id` integer, required
    - `name` string, required

## Other responses

- `400`: Bad request syntax or unsupported method
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/9d8804f81a10?raw)