Ctrl+K

Changelog

Changelog#

rss_feed Subscribe via RSS

2026-03-27#

  • [Feature] Diagonal borders support in spreadsheet endpoints

    • Spreadsheets

    The get sheet data and sheet update Spreadsheets API endpoints now support retrieving and setting diagonal borders.

    Helpful Links:

  • [Feature] Diagonal borders support in content endpoints

    • Content

    The get table cells and batch cells edit endpoints now support retrieving and setting diagonal borders.

    Helpful Links:

2026-03-26#

  • [Feature] LLM-friendly documentation now available via /llms.txt
    We’ve added /llms.txt support to the Workiva Developer Portal, making our API documentation easily accessible to large language models and AI-powered tools. Each API version has its own llms.txt file with a complete page listing, including support for the Chains and Wdata APIs.

    Helpful Links:

2026-03-18#

  • [Feature] Expanded document, spreadsheet, and table properties

    • Documents
    • Spreadsheets
    • Content

    Document and spreadsheet resources now include a properties field containing configuration and setup details:

    • Documents: page layout, page margins, background color, page border, line numbers type, print bleed, and table formats (resize rows to fit).

    • Spreadsheets: table formats (resize rows to fit). These properties can also be updated via PATCH operations on the respective document and spreadsheet endpoints.

    Additionally, table properties now include alternateRowFills and printArea fields.

2026-03-17#

  • [Feature] Added Enclosed list sequence

    • Documents
    • Presentations
    • Spreadsheets

    We’ve updated our list sequence to include the enclosed type, which allows for more flexible list formatting options.

2026-03-16#

  • [Bug Fix] The container field on the File schema is no longer readOnly
    The container field within the File schema is no longer marked as readOnly. This was previously incorrect since it is possible to specify the container when creating a file.

    • Files

  • [Feature] Added Distributed Horizontal & Vertical Alignment
    We’ve enhanced our alignment options for document sections and spreadsheet cells by adding support for distributed horizontal and vertical alignment. These new alignment types allow you to evenly distribute content across a section or cell range, providing more control over the layout and presentation of your documents and spreadsheets.

2026-03-13#

  • [Feature] Added support for specifying the name of the copied files
    When using the file copy endpoint, you can now specify a destinationName in the options to set the name of the copied file. If you don’t provide a destinationName, the default behavior will be used.

    Helpful Links:

2026-03-05#

  • [Feature] Added Workiva kind to export file by id endpoint
    You can now export Workiva files in their original format using the export file by ID endpoint. Your file will be delivered as a convenient tar.gz archive, preserving all Workiva-specific formatting and functionality. This gives you greater flexibility in how you work with your Workiva content.

    Helpful Links:

2026-02-26#

  • [Feature] Retrieve tables from documents and presentations

    • Documents
    • Presentations

    You can now retrieve the collection of tables within a document or presentation using the new endpoints:

    • GET /documents/{documentId}/tables

    • GET /presentations/{presentationId}/tables These endpoints return all tables along with their names, indices, and parent content references.

    Helpful Links:

2026-02-11#

  • [Feature] Added useDashesForZeros field in ValueFormat schema
    We’ve updated the documentation with the useDashesForZeros field in the ValueFormat schema to clarify that this field only applies when the valueFormatType is set to NUMBER. This change ensures that developers have accurate information about how to use this formatting option effectively.

2026-02-02#

  • [Feature] Error responses now include API version
    We’re making it easier for you to debug and troubleshoot your API integrations by including a helpful version field that shows exactly which API version was in use when an issue occurred. This enhancement gives you the context you need to quickly identify and resolve problems.

2026-01-29#

  • [Bug Fix] Explicly marked RangeValues items as nullable

    • Spreadsheets

    The items property within the values array of the RangeValues schema has been explicitly marked as nullable: true. This change clarifies that individual cell values within the rows can be null, which preserves whatever value is currently in the cell.

2026-01-01#

  • [Feature] Changelog introduced
    Workiva is excited to introduce changelogs for this API version. From now on, you’ll find detailed documentation about API changes right here. We are committed to keeping you informed and making your integrations go as smoothly as possible. Thank you for building with us.

  • [Breaking] Path simplification
    We’ve streamlined all API paths by removing the following prefixes:

    • /platform/v1/

    • /admin/v1/

    • /prototype/platform/

    • /prototype/admin/

    • /iam/v1/ Previously, these segments indicated different API versions. With our new date-based versioning system, we’ve unified paths for improved clarity and consistency.

    Helpful Links:

  • [Breaking] Prototype endpoints promoted or removed
    We’ve promoted select prototype functionality to general availability in the 2026-01-01 version. Other prototype endpoints have been removed as part of our commitment to API quality and stability. Moving forward, we’ll create Preview versions of the Public API for new features with the intention of promoting them to the stable version after thorough testing and feedback. Existing prototype endpoints remain in the 2022-01-01 version for backward compatibility.

    Helpful Links:

  • [Breaking] Legacy spreadsheets endpoints retired

    • Spreadsheets

    We’ve retired all endpoints under the /spreadsheets/v1 path in favor of our improved spreadsheet management endpoints. Please migrate to the endpoints that were previously under the /platform/v1/spreadsheets path for enhanced functionality and performance.

    Helpful Links:

  • [Breaking] Synchronous CSV export endpoint replaced with async alternative

    • Graph

    The GET /platform/v1/graph/reports/{reportId}/csv endpoint has been replaced with our asynchronous CSV export endpoint which has been available in the 2022-01-01 version for several years. This async endpoint provides significantly better performance for large reports and is available in the 2026-01-01 version as well.

    Helpful Links:

  • [Breaking] Standardized URL patterns without trailing slashes
    We’ve standardized our URL patterns for improved consistency. The API no longer accepts paths with trailing slashes (e.g., /documents/) and will return a 404 error. Please use paths without trailing slashes (e.g., /documents). This change improves routing consistency and aligns with REST best practices.

    Helpful Links:

  • [Breaking] Enhanced security for OrgReportUsers endpoint

    • Reports

    We’ve strengthened security by requiring the organization:read scope for the OrgReportUsers endpoint. Please ensure your API grant includes this scope in order to use this endpoint.

    Helpful Links:

  • [Breaking] Improved user retrieval with workspace memberships endpoint

    • Users

    The GET /platform/v1/users endpoint has been replaced with our workspace memberships endpoint, which provides enhanced filtering and better organization of user data.

    Helpful Links:

  • [Breaking] Transitioned to PATCH operations for Section and Sheet updates

    • Documents
    • Spreadsheets

    We’ve modernized our update operations by transitioning from PUT to PATCH for the following endpoints:

    • /documents/{documentId}/sections/{sectionId}

    • /spreadsheets/{spreadsheetId}/sheets/{sheetId} PATCH operations enable partial updates and provide more explicit control over changes, improving developer experience.

    Helpful Links:

  • [Breaking] Async PATCH endpoints for Documents and Spreadsheets

    • Documents
    • Spreadsheets

    PATCH operations on sections and sheets now execute asynchronously for improved performance and reliability. These endpoints return an operation reference in the Location header that you can poll to monitor update status.

    Helpful Links:

  • [Breaking] Removed Support for ‘name contains’ filter on GET /files endpoint

    • Files

    We’ve removed the ‘name contains’ filter on our GET /files endpoint to improve performance with large datasets. Please use the available filtering options for efficient file retrieval.

    Helpful Links:

  • [Feature] Comprehensive Organization and Workspace management APIs

    • Organizations
    • Workspaces
    • Users
    • Memberships
    • Groups
    • Roles

    We’re pleased to announce a comprehensive suite of APIs for managing users, organizations, and workspaces within the Workiva Platform. These endpoints enable you to automate critical workflows including:

    • Creating and managing workspaces

    • Managing workspace memberships

    • Creating and administering groups

    • Provisioning and managing organization users

    • Assigning, listing, and revoking roles for users and memberships

    • Retrieving lists of groups, users, roles, memberships, workspaces, and organizations Please note: These endpoints use UUIDs as Role IDs for improved consistency.

    Helpful Links:

  • [Feature] Comprehensive file management capabilities

    • Files

    We’ve introduced a powerful suite of endpoints for comprehensive file management. You can now:

    • Retrieve, import, and export non-Workiva file types (PDF, PNG, CSV, and more), which Workiva calls “Supporting Documents”

    • Manage file permissions

    • Move files to trash and restore them as needed

    • Retrieve lists of trashed files for audit and recovery purposes

    Helpful Links:

  • [Feature] Permissions management

    • Permissions

    We’ve introduced dedicated endpoints for comprehensive permissions management. You can now retrieve, assign, modify, and remove permissions for files programmatically, providing fine-grained access control for your integrations.

    Helpful Links:

  • [Breaking] Tasking updates

    • Tasks

    We have updated the Tasks endpoints with some breaking and additive changes that improves how a Task is managed. These improvements were made to enable seamless Task Management, most notably when used in conjunction with Sustainability endpoints. The changes are listed below:

    • A Task can now have multiple Assignees. Previously, a Task could only have a single Assignee.

    • ApprovalSteps have been added to a Task to facilitate the approval process.

    • We have added the Submit a Task action via the /task/{taskId}/actionSubmission endpoint.

    Helpful Links: