agents

Create Agent

Create a new agent owned by the current identity.

TOS-318: when body.tts_voice is omitted, the handler picks an ElevenLabs voice via suggest_voice (4s hard timeout) and writes it to identities.tts_voice before returning. On any failure path it writes PLATFORM_FALLBACK_VOICE_ID instead. The agent is NEVER persisted with a NULL voice.

post/api/agents

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
  • Auth: none declared

Headers

x-impersonate-identity-idstring nullable

Request body

wallet_source'creator' | 'own' nullable
display_namestring required
charter_inherited_boundaries_reviewedboolean
charter_activateboolean
descriptionstring nullable
taglinestring nullable
visual_brand_guidelinesstring nullable
visual_brand_logo_urlstring nullable
system_promptstring nullable

Mind Constitution: who the identity is. Distilled into identity, role, expertise, and trait beliefs in its Mind; instructions written here do NOT reach the model. Put rules in operating_instructions.

operating_instructionsstring nullable

Operating Instructions: rules injected verbatim into every turn this identity answers. Empty string clears them.

configobject
status'active' | 'archived'
connection_policy'off' | 'request' | 'auto' nullable
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'
home_library_idstring uuid nullable
verification_artifactboolean

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.