agents

Set Agent Home

Move an agent to another home folder (TOS-2150). Active owners only.

Deliberately NOT a field on PUT /api/agents/{id}. A home folder is not part of the agent's self-description; it is the OWNER filing an object in their namespace, and authorizing it needs a second axis the profile endpoint does not check: write reach on the TARGET folder, exactly like moving a document or an integration between folders. So this endpoint takes the ownership axis (an explicit owner grant - an agent may not re-file itself) plus that reach check.

The agent's address changes and it lists under a different folder. For an agent whose owners are its folder's administrators (every agent created since home-folder authority), moving it CHANGES WHO OWNS IT: the owners become the destination folder's administrators, and the previous folder's administrators lose ownership unless they also administer the destination. To add a co-owner without losing anyone, use agent_share instead.

put/api/agents/{agent_id}/home

Request

  • Base URL: https://app.thinqos.com (the document declares no server; this is the origin it was published from)
  • URL: https://app.thinqos.com/api/agents/{agent_id}/home
  • Auth: none declared

Path parameters

agent_idstring uuid required

Headers

x-impersonate-identity-idstring nullable

Request body

home_library_idstring uuid required

Response

Successful Response

can_receive_chatboolean
funding_selectionobject nullable
idstring uuid required
display_namestring required
avatar_urlstring nullable required
descriptionstring nullable required
taglinestring nullable
visual_brand_guidelinesstring nullable
visual_brand_logo_urlstring nullable
system_promptstring nullable required
operating_instructionsstring nullable
charter_creationobject nullable
can_edit_charterboolean nullable

Owner-only advisory for this detail request's charter edit authority. Missing/null is unknown; writes still recheck authority and charter version.

configobject required
status'active' | 'archived' required
connection_policy'off' | 'request' | 'auto' required
owned_by_callerboolean
relationship'myself' | 'built' | 'hired' | 'connected' | 'public'
registration_idsstring[]
tts_voicestring nullable
tts_voice_backupstring nullable
browser_automation_enabledboolean
web_browse_enabledboolean
reply_workflow'manual' | 'draft' | 'send'
unreviewed_information_scope'limited' | 'full'
learning_scope'private' | 'discretion' | 'open'

TOS-6036: what an agent carries from one person it serves to the next.

Owner-only, agent-level, stored at identity_config.config.learning_scope. Distinct from :class:UnreviewedInformationScope, which only widens READ access for auto-sent replies and says nothing about what a teach WRITE is scoped to.

  • private keeps every learned item partitioned to the person who said it (the pre-TOS-6036 behaviour).
  • discretion (default) shares items classified about_work with everyone the agent serves and keeps about_person items private.
  • open shares everything the agent learns with everyone it serves.
self_improvement_policy'off' | 'review' | 'minor'
default_mode'human' | 'agent_augmented' | 'agent'
self_improvement_mode'manual' | 'augmented' | 'autonomous'
is_globalboolean
kind'person' | 'agent'
agent_keystring nullable
deleted_atstring nullable
archetypestring nullable
tagsstring[]
classification_sourcestring nullable
classified_atstring nullable
home_library_idstring uuid nullable
addressstring nullable
home_domain_labelstring nullable
ownership_source'home_folder' | 'controllers'
disclose_capabilitiesboolean
disclose_reputationboolean
warningsstring[]

Changes

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