Updates the name and/or description of a document. Note: A name or description must be provided or the API will return a Bad Request error.
Renaming a document follows the app’s draft/publish workflow:
| Document Type | Behavior |
|---|---|
| Draft | Renamed directly |
| Published (no existing draft) | Creates draft > Renames draft > Publishes draft |
Published (existing draft, clearExistingDraft: true) | Discards existing draft > Creates new draft > Renames > Publishes |
Published (existing draft, clearExistingDraft not set) | Returns 409 Conflict |
Can be either an Organization API Key or Personal Access Token (PAT).
Include in the Authorization header as: Bearer YOUR_TOKEN
Document identifier
New name for the document.
1 - 255Updated description of the document. Set as null to clear the description.
1024If true, discards any existing draft before renaming.
Note: This parameter is required when a draft exists for the document.