Invoke Skill Topic Update

post/api/v1/skills/topic.update/invoke

Update a Topic's metadata — rename (name), retitle, set type / theme_color / status / description / icon, or rebind client_id. Only the provided fields change. Set status='active' to unarchive; soft-deleted topics are terminal (answer not-found).

Request bodyapplication/json

Field	Type	Description
`topic_id`required	`string`	Topic permakey (preferred) or UUID
`name`	`string \| null`	New topic name (rename)
`type`	`string \| null`	client \| matter \| process_period \| advisory \| compliance \| internal
`status`	`string \| null`	active \| archived. Set 'active' to unarchive; soft-deleted topics are terminal and answer not-found.
`theme_color`	`string \| null`	Hex like #DAFBE1
`client_id`	`string \| null`	UUID of the client to bind
`description`	`string \| null`	Free-text topic description
`icon`	`string \| null`	Topic icon

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

—

show nested

Field	Type	Description
`stub_fields`	`string[]`	—
`warnings`	`string[]`	—
`topic_id`	`string`	The topic's permakey (the public id).
`permakey`	`string`	The 7-char public topic id — THE id to show users and reuse in later topic_* calls (UUIDs are internal).
`name`	`string`	—
`type`	`string`	—
`status`	`string`	—

correlation_idrequired string —

401Authentication required

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

403Insufficient permissions

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

404Skill not found

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

429Rate limit exceeded

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

5XXInternal server error

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

curl https://api.dev.arch.ie/api/v1/skills/topic.update/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "topic_id": "string",
       "name": null,
       "type": null,
       "status": null,
       "theme_color": null,
       "client_id": null,
       "description": null,
       "icon": null
     }'