---
title: "Set Form Access For Plan Manager"
method: POST
path: "/api/v2/retool/forms-app/org-access"
tags: ["v2", "Forms App"]
---

# Set Form Access For Plan Manager

`POST /api/v2/retool/forms-app/org-access`

Enable (or disable) forms app usage for the requesting retool org

Org is extracted from Retool metadata / headers

If the org does not currently exist in the forms_org_admin table, they will be created

## Query parameters

- `enabled` boolean
- `email_auto_gen_notifications_to` string, email

## Response `200`

Successful Response

- ApiResponseJSONFormsOrgAdminModel
  - `data` FormsOrgAdminModel[] — List of items returned in the response following given criteria
    - `id` string, uuid, required
    - `created_at` string, date-time
    - `plan_manager_id` string, uuid, required
    - `enabled` boolean
    - `created_count` integer
    - `completed_count` integer
    - `idv_count` integer
    - `leads_generated_count` integer
    - `auto_gen_count` integer
    - `email_auto_gen_notifications_to` string, email, nullable
    - `auto_gen_template_metadata` unknown
    - `default_template` boolean
  - `meta` ApiResponseMeta — Standardised Api Response Meta Not always required (except for example; with paginated results) Future: Could provide base that includes org information, copy-write etc
    - `processing_time_ms` integer, nullable
    - `total_records` integer, nullable
    - `page` integer, nullable
    - `limit` integer, nullable
    - `count` integer, nullable
    - `cursor` unknown
    - `cursor_last` unknown
    - `more_data_available` boolean, nullable
  - `messages` ApiResponseMessage[], nullable — Response Messages
    - `message_type` 'debug' | 'info' | 'warning' | 'error', required
    - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/caresquare/apis/fastapi.md) · [All operations](https://skmtc.dev/caresquare/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/caresquare/fastapi/revisions/c9df874d8d59/schema)