update_source
Update a source
Corrects a source's title, language or text; a call sends at least one of the three. Any member who can see the source can use it. It never deletes a source, and it never changes the text of an uploaded file.
What the server says
The description an agent is given, word for word. This tool makes changes.
Correct a source's title, language or text. Send at least one of the three: a call with none is refused. An uploaded file's text cannot be edited.
Input
| Field | Type | Required | What it takes |
|---|---|---|---|
title | text | no | 1 to 200 characters |
language | text | no | matches ^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$ |
body | text | no | not empty |
sourceId | text | yes | not empty; The source's id, as list_sources or create_text_source answers it. |
Refusals
A refusal comes back as the tool's result, marked as an error, with the code and what explains it.
| Code | What it means |
|---|---|
source_not_found | A source named is not one the person can see, is in another team, or was deleted. |
upload_body_not_editable | The source is an uploaded file, whose text cannot be edited. Its title and language can. |
source_body_too_long | The text is over 60,000 characters. The refusal says the limit and the length. |
Every tool can also answer rate_limited and not_a_member: see Limits and Keys.