AI assistants

Claude, ChatGPT and other assistants through MCP: consent, connections, drafts waiting for approval, the call log and the company policy with its kill switch.

GET/v1/ai-assistants/drafts

Assistant requests waiting for approval

`scope=all` (integrations managers): everyone’s; otherwise the caller’s own.

Access: Signed-in members only (web or Android session) — not for API keys. Permission ai.assistants or settings.integrations.

Parameters

scopequery: "mine" | "all"
statusquery: "open" | "closed"

Response · 200

datarequired: array of McpDraft
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/ai-assistants/drafts' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "tool": "string",
      "summary": "string",
      "arguments": null,
      "status": "pending",
      "member": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "client": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "created_at": "2026-10-06T05:30:00.000Z",
      "expires_at": "2026-10-06T05:30:00.000Z",
      "decided_at": "2026-10-06T05:30:00.000Z",
      "decided_by_name": "string",
      "decision_note": "string",
      "result": null
    }
  ],
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/ai-assistants/drafts/{id}/approve

Approve an assistant’s request

Runs the API call the assistant asked for as the member, through the connection as it is now (its scopes and the member’s permissions apply). The draft’s member or an integrations manager.

Access: Signed-in members only (web or Android session) — not for API keys. Permission ai.assistants or settings.integrations.

Parameters

idpathrequired: Id
Opaque record id.

Request body

note: string

Response · 200

datarequired: McpDraft
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/ai-assistants/drafts/{id}/approve' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"note":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "tool": "string",
    "summary": "string",
    "arguments": null,
    "status": "pending",
    "member": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "client": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "created_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "decided_at": "2026-10-06T05:30:00.000Z",
    "decided_by_name": "string",
    "decision_note": "string",
    "result": null
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/ai-assistants/drafts/{id}/reject

Reject an assistant’s request

Access: Signed-in members only (web or Android session) — not for API keys. Permission ai.assistants or settings.integrations.

Parameters

idpathrequired: Id
Opaque record id.

Request body

note: string

Response · 200

datarequired: object
data.idrequired: Id
Opaque record id.
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/ai-assistants/drafts/{id}/reject' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"note":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/me/ai-assistants

The assistants the caller connected

Access: Signed-in members only (web or Android session) — not for API keys.

Response · 200

datarequired: array of McpConnection
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/me/ai-assistants' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "client": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "client_id": "string",
        "name": "string",
        "verified": true,
        "client_uri": "string"
      },
      "member": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "scopes": [
        "string"
      ],
      "autonomy": "string",
      "status": "string",
      "consented_at": "2026-10-06T05:30:00.000Z",
      "last_used_at": "2026-10-06T05:30:00.000Z",
      "revoked_at": "2026-10-06T05:30:00.000Z"
    }
  ],
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/me/ai-assistants/activity

What the caller’s assistants did

Access: Signed-in members only (web or Android session) — not for API keys.

Parameters

cursorquery: string
limitquery: integer
connection_idquery: Id
Opaque record id.

Response · 200

datarequired: array of McpCallLog
metarequired: object
meta.next_cursorrequired: string or null
meta.has_morerequired: boolean

Request

curl -X GET 'https://api.propzolo.com/v1/me/ai-assistants/activity' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "tool": "string",
      "outcome": "string",
      "autonomy": "string",
      "error_code": "string",
      "http_status": 0,
      "latency_ms": 0,
      "arguments_hash": "string",
      "pending_action_id": "string",
      "request_id": "string",
      "member": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "client": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "created_at": "2026-10-06T05:30:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": "string",
    "has_more": true
  }
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

DELETE/v1/me/ai-assistants/{id}

Disconnect one of the caller’s assistants

Every token ends at once and open drafts are cancelled.

Access: Signed-in members only (web or Android session) — not for API keys.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: object
data.idrequired: Id
Opaque record id.
data.revokedrequired: true
metarequired: object

Request

curl -X DELETE 'https://api.propzolo.com/v1/me/ai-assistants/{id}' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "revoked": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/oauth/consent

Approve or deny an assistant’s request to connect

The consent screen’s submit: the authorization request is checked again, then the member’s choice of scopes and autonomy is recorded and a single-use code issued. Answers the URL to send the browser to (the client’s redirect URI with `code` or `error`).

Access: Signed-in members only (web or Android session) — not for API keys.

Request body

requestrequired: map of string
decisionrequired: "approve" | "deny"
scopes: array of string
autonomy: "read" | "draft" | "execute"

Response · 200

datarequired: object
data.redirect_torequired: string
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/oauth/consent' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"request":{},"decision":"approve","scopes":[],"autonomy":"draft"}'

Response example

{
  "data": {
    "redirect_to": "string"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/settings/ai-assistants

AI assistant settings

The policy, member overrides, clients with a decision or a connection, and the last 7 days’ usage.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.integrations.

Response · 200

datarequired: McpOverview
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/settings/ai-assistants' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "settings": {
      "enabled": true,
      "default_autonomy": "read",
      "group_caps": {
        "leads": "read",
        "properties": "read",
        "site_visits": "read",
        "tasks": "read"
      },
      "allow_dynamic_clients": true
    },
    "members": [
      {
        "member_id": "cmusrceel0000q7kaafxqi1om",
        "name": "string",
        "autonomy": "off",
        "updated_at": "2026-10-06T05:30:00.000Z"
      }
    ],
    "clients": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "client_id": "string",
        "name": "string",
        "source": "string",
        "status": "allowed",
        "pending": true,
        "requested_at": "2026-10-06T05:30:00.000Z",
        "redirects": [
          {
            "kind": "web",
            "host": "string"
          }
        ],
        "claimed_site": "string",
        "connections": 0,
        "last_used_at": "2026-10-06T05:30:00.000Z"
      }
    ],
    "usage": {
      "since": "2026-10-06T05:30:00.000Z",
      "calls": 0,
      "by_outcome": {},
      "by_tool": [
        {
          "tool": "string",
          "calls": 0
        }
      ],
      "active_connections": 0,
      "open_drafts": 0
    },
    "endpoint": "string"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

PATCH/v1/settings/ai-assistants

Change the AI assistant settings

Only the keys sent change. Needs a fresh TOTP step-up (it opens CRM data to third-party AI). Audited.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.integrations.

Request body

enabled: boolean
default_autonomy: "read" | "draft" | "execute"
group_caps: object
The most any assistant may do per tool group (absent: the default applies).
group_caps.leads: "read" | "draft" | "execute"
group_caps.properties: "read" | "draft" | "execute"
group_caps.site_visits: "read" | "draft" | "execute"
group_caps.tasks: "read" | "draft" | "execute"
allow_dynamic_clients: boolean

Response · 200

datarequired: McpSettings
metarequired: object

Request

curl -X PATCH 'https://api.propzolo.com/v1/settings/ai-assistants' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"enabled":true,"default_autonomy":"read","group_caps":{"leads":"read","properties":"read","site_visits":"read","tasks":"read"},"allow_dynamic_clients":true}'

Response example

{
  "data": {
    "enabled": true,
    "default_autonomy": "read",
    "group_caps": {
      "leads": "read",
      "properties": "read",
      "site_visits": "read",
      "tasks": "read"
    },
    "allow_dynamic_clients": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/settings/ai-assistants/activity

The assistant call log of the company

Client, member, tool, autonomy, outcome and latency per call; arguments only as a hash.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.integrations.

Parameters

cursorquery: string
limitquery: integer
connection_idquery: Id
Opaque record id.

Response · 200

datarequired: array of McpCallLog
metarequired: object
meta.next_cursorrequired: string or null
meta.has_morerequired: boolean

Request

curl -X GET 'https://api.propzolo.com/v1/settings/ai-assistants/activity' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "tool": "string",
      "outcome": "string",
      "autonomy": "string",
      "error_code": "string",
      "http_status": 0,
      "latency_ms": 0,
      "arguments_hash": "string",
      "pending_action_id": "string",
      "request_id": "string",
      "member": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "client": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "created_at": "2026-10-06T05:30:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": "string",
    "has_more": true
  }
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

PUT/v1/settings/ai-assistants/clients/{id}

Allow or block an assistant client

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.integrations.

Parameters

idpathrequired: Id
Opaque record id.

Request body

statusrequired: "allowed" | "blocked" or null

Response · 200

datarequired: object
data.client_idrequired: Id
Opaque record id.
data.statusrequired: "allowed" | "blocked" or null
metarequired: object

Request

curl -X PUT 'https://api.propzolo.com/v1/settings/ai-assistants/clients/{id}' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"status":"allowed"}'

Response example

{
  "data": {
    "client_id": "cmusrceel0000q7kaafxqi1om",
    "status": "allowed"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/settings/ai-assistants/connections

Every member’s connected assistants

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.integrations.

Response · 200

datarequired: array of McpConnection
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/settings/ai-assistants/connections' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "client": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "client_id": "string",
        "name": "string",
        "verified": true,
        "client_uri": "string"
      },
      "member": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "scopes": [
        "string"
      ],
      "autonomy": "string",
      "status": "string",
      "consented_at": "2026-10-06T05:30:00.000Z",
      "last_used_at": "2026-10-06T05:30:00.000Z",
      "revoked_at": "2026-10-06T05:30:00.000Z"
    }
  ],
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

DELETE/v1/settings/ai-assistants/connections/{id}

Disconnect a member’s assistant

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.integrations.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: object
data.idrequired: Id
Opaque record id.
data.revokedrequired: true
metarequired: object

Request

curl -X DELETE 'https://api.propzolo.com/v1/settings/ai-assistants/connections/{id}' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "revoked": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

PUT/v1/settings/ai-assistants/members/{id}

A member’s assistant autonomy (or off)

`off` refuses the member’s assistants at once; null follows the company default again.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.integrations.

Parameters

idpathrequired: Id
Opaque record id.

Request body

autonomyrequired: "off" | "read" | "draft" | "execute" or null

Response · 200

datarequired: object
data.member_idrequired: Id
Opaque record id.
data.autonomyrequired: "off" | "read" | "draft" | "execute" or null
metarequired: object

Request

curl -X PUT 'https://api.propzolo.com/v1/settings/ai-assistants/members/{id}' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"autonomy":"off"}'

Response example

{
  "data": {
    "member_id": "cmusrceel0000q7kaafxqi1om",
    "autonomy": "off"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/settings/ai-assistants/stop

Kill switch: stop every assistant now

Turns access off; every token is refused on its next request. No step-up: stopping is never harder.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.integrations.

Response · 200

datarequired: McpSettings
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/settings/ai-assistants/stop' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "enabled": true,
    "default_autonomy": "read",
    "group_caps": {
      "leads": "read",
      "properties": "read",
      "site_visits": "read",
      "tasks": "read"
    },
    "allow_dynamic_clients": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

{ "data": [ { "id": "cmusrceel0000q7kaafxqi1om", "tool": "string", "summary": "string", "arguments": null, "status": "pending", "member": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "client": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "created_at": "2026-10-06T05:30:00.000Z", "expires_at": "2026-10-06T05:30:00.000Z", "decided_at": "2026-10-06T05:30:00.000Z", "decided_by_name": "string", "decision_note": "string", "result": null } ], "meta": {} }

{ "data": { "id": "cmusrceel0000q7kaafxqi1om", "tool": "string", "summary": "string", "arguments": null, "status": "pending", "member": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "client": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "created_at": "2026-10-06T05:30:00.000Z", "expires_at": "2026-10-06T05:30:00.000Z", "decided_at": "2026-10-06T05:30:00.000Z", "decided_by_name": "string", "decision_note": "string", "result": null }, "meta": {} }

{ "data": [ { "id": "cmusrceel0000q7kaafxqi1om", "client": { "id": "cmusrceel0000q7kaafxqi1om", "client_id": "string", "name": "string", "verified": true, "client_uri": "string" }, "member": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "scopes": [ "string" ], "autonomy": "string", "status": "string", "consented_at": "2026-10-06T05:30:00.000Z", "last_used_at": "2026-10-06T05:30:00.000Z", "revoked_at": "2026-10-06T05:30:00.000Z" } ], "meta": {} }

{ "data": [ { "id": "cmusrceel0000q7kaafxqi1om", "tool": "string", "outcome": "string", "autonomy": "string", "error_code": "string", "http_status": 0, "latency_ms": 0, "arguments_hash": "string", "pending_action_id": "string", "request_id": "string", "member": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "client": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "created_at": "2026-10-06T05:30:00.000Z" } ], "meta": { "next_cursor": "string", "has_more": true } }

curl -X POST 'https://api.propzolo.com/v1/oauth/consent' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Content-Type: application/json' \ -d '{"request":{},"decision":"approve","scopes":[],"autonomy":"draft"}'

{ "data": { "settings": { "enabled": true, "default_autonomy": "read", "group_caps": { "leads": "read", "properties": "read", "site_visits": "read", "tasks": "read" }, "allow_dynamic_clients": true }, "members": [ { "member_id": "cmusrceel0000q7kaafxqi1om", "name": "string", "autonomy": "off", "updated_at": "2026-10-06T05:30:00.000Z" } ], "clients": [ { "id": "cmusrceel0000q7kaafxqi1om", "client_id": "string", "name": "string", "source": "string", "status": "allowed", "pending": true, "requested_at": "2026-10-06T05:30:00.000Z", "redirects": [ { "kind": "web", "host": "string" } ], "claimed_site": "string", "connections": 0, "last_used_at": "2026-10-06T05:30:00.000Z" } ], "usage": { "since": "2026-10-06T05:30:00.000Z", "calls": 0, "by_outcome": {}, "by_tool": [ { "tool": "string", "calls": 0 } ], "active_connections": 0, "open_drafts": 0 }, "endpoint": "string" }, "meta": {} }

curl -X PATCH 'https://api.propzolo.com/v1/settings/ai-assistants' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Content-Type: application/json' \ -d '{"enabled":true,"default_autonomy":"read","group_caps":{"leads":"read","properties":"read","site_visits":"read","tasks":"read"},"allow_dynamic_clients":true}'

{ "data": { "enabled": true, "default_autonomy": "read", "group_caps": { "leads": "read", "properties": "read", "site_visits": "read", "tasks": "read" }, "allow_dynamic_clients": true }, "meta": {} }

PUT/v1/settings/ai-assistants/members/{id}

A member’s assistant autonomy (or off)

`off` refuses the member’s assistants at once; null follows the company default again.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.integrations.

Parameters

idpathrequired: Id
Opaque record id.

Request body

autonomyrequired: "off" | "read" | "draft" | "execute" or null

Response · 200

datarequired: object
data.member_idrequired: Id
Opaque record id.
data.autonomyrequired: "off" | "read" | "draft" | "execute" or null
metarequired: object

Request

curl -X PUT 'https://api.propzolo.com/v1/settings/ai-assistants/members/{id}' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"autonomy":"off"}'

Response example

{
  "data": {
    "member_id": "cmusrceel0000q7kaafxqi1om",
    "autonomy": "off"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.