gtm-internal
gtm-internal

Update Gtm Agent Desk

Flip desk switches for one domain, and return the whole recomputed panel.

Returning the panel (not just the changed field) is what lets the UI show the SERVER's state rather than the click's intent — these toggles change what a live public desk does, and an optimistic flip that silently failed would leave the panel lying about a customer's desk.

Refuses to CREATE a desk (404): a missing desk row means this domain was never provisioned for AgentDesk, and one conjured from a toggle would have no slug convention, no offerings and no prompt. Refuses an unknown retrieval_mode (400): nothing downstream would error on it — desk_reads_index reads anything unrecognised as "exa" — so the desk would keep using Exa while the column and this panel both claimed otherwise.

patch/gtm-internal/accounts/{org_id}/domains/{domain_id}/agent-desk

Request

  • Base URL
    https://api-v1.unusual.ai (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: /auth/login

Path parameters

org_idstring required
domain_idstring required

Request body

enabledboolean nullable
post_enabledboolean nullable
answer_pages_enabledboolean nullable
retrieval_modestring nullable
knowledge_auto_updatestring nullable
index_on_googleboolean nullable
index_on_bingboolean nullable

Response

Successful Response

existsboolean
domain_idstring required
hoststring nullable
desk_idstring nullable
slugstring nullable
enabledboolean
post_enabledboolean
answer_pages_enabledboolean
retrieval_modestring
knowledge_auto_updatestring
knowledge_auto_update_effectivestring
auto_activations_per_dayinteger
daily_answer_limitinteger nullable
index_ingest_enabledboolean
index_on_googleboolean
index_on_bingboolean

Changes

No recorded changes to this operation across all 1 revision of this API.