Forms
Every Forms tool, with the scope it needs, its arguments and the API operation it calls.
6 tools
Request form approvals
Changes dataatlas_forms_approvals_request
Mark a task as pending approval so a reviewer is prompted to approve or reject it. Use this to route a form-submitted task into the approval workflow. Idempotent per MCP call.
- Scope
forms:write- Calls
- Example prompt
- Send task tsk_a1b2c3 for approval.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskId | string | Yes |
Review form approvals
Changes dataatlas_forms_approvals_review
Approve or reject a task that is pending approval. Set `approve` to true to approve, false to reject; the decision and reviewer are recorded on the task. Idempotent per MCP call.
- Scope
forms:write- Calls
- Example prompt
- Approve the pending expense task tsk_a1b2c3.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskId | string | Yes | |
approve | boolean | Yes | true to approve the task, false to reject it. |
Create forms
Changes dataatlas_forms_create
Create an intake form from a name, target project, and an ordered list of fields. `titleField` must reference one of the declared field keys - its answer becomes the created task title. Idempotent per MCP call.
- Scope
forms:write- Calls
- Example prompt
- Create a bug-report intake form in the Support project.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
name | string | Yes | |
description | string | No | |
fields | array of object | Yes | |
titleField | string | Yes | Field key whose answer becomes the created task title. |
Delete forms
Destructiveatlas_forms_delete
Permanently delete an intake form by id. Existing tasks created from prior submissions are unaffected. Idempotent per MCP call.
- Scope
forms:write- Calls
- Example prompt
- Delete the deprecated Q1 survey form.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List forms
Read onlyatlas_forms_list
List the intake forms visible to the caller tenant one page at a time, newest first by default, including field schema, public slug, owner, and enabled state, so an MCP host can audit or summarise the forms surface without opening the dashboard. Pass `nextCursor` back as `cursor` for the next page.
- Scope
forms:read- Calls
- Example prompt
- Show me all our intake forms and whether they are enabled.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "createdAt" | "updatedAt" | "name" | No | The field to sort on: createdAt, updatedAt, name. createdAt by default. |
order | "asc" | "desc" | No | asc or desc. desc by default. |
Update forms
Changes dataatlas_forms_update
Update an intake form by id - change its name, description, fields, title field, or enabled state. Supply at least one mutable field alongside the id. Idempotent per MCP call.
- Scope
forms:write- Calls
- Example prompt
- Disable the old vendor-onboarding form.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
name | string | No | |
description | string | null | No | |
fields | array of object | No | |
titleField | string | No | Machine key for a field (lower_snake_case, starts with a letter). |
enabled | boolean | No |