Skip to content

Update Copilot Personal Wiki Sources

PUT
/copilot/personal-wiki/sources

Change what the assistant may read.

PARTIAL: an omitted field is left alone, an explicit one changes it. So omitting email_enabled and sending false are different instructions.

SWITCHING A SOURCE OFF DOES NOT UNLEARN. It stops new facts arriving from there; what was already derived stays until it is forgotten one fact at a time through POST /copilot/personal-wiki/forget.

Authorizations

Parameters

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body required

Mirror of PersonalWikiSourcesUpdateRequest.

PARTIAL: the handler applies exclude_unset, so an omitted field is left alone and an explicit value changes it. Sending email_enabled: false is not the same instruction as omitting it.

object
additional_mailbox_ids
Any of:
Array<integer>
<= 20 items
calendar_enabled
Any of:
boolean
docs_enabled
Any of:
boolean
document_ids
Any of:
Array<string>
<= 20 items
email_enabled
Any of:
boolean
primary_mailbox_id
Any of:
integer
work_enabled
Any of:
boolean

Responses

200

Successful Response

object
data
required

An open envelope for one memory, wiki or sharing answer.

Open because the personal wiki is a DOCUMENT whose sections follow what has been learned about a person, and because each fact carries provenance - which mailbox or meeting it came from - that grows as new sources are connected. Pinning the shape would silently drop the provenance on the newest source, and on a “what do you know about me” surface a fact with no visible origin is worse than no fact.

object
key
additional properties
any
pagination
Any of:
object
has_next
required

Whether there are more pages

boolean
limit
required

Items per page

integer
next_cursor
Any of:
string
notes
Any of:
Array<string>
page
required

Current page number (1-indexed)

integer
total
required

Total number of items

integer
total_available
Any of:
integer
total_is_lower_bound
Any of:
boolean

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string