---
title: "Set sheet publish status"
method: PUT
path: "/sheets/{sheetId}/publish"
tags: ["sheets"]
---

# Set sheet publish status

`PUT /sheets/{sheetId}/publish`

Sets the publish status of the sheet and returns the new status, including the URLs of any enabled publishings.

## Headers

- `Content-Type` string

## Request body

- SheetPublishRequest — Describes the sheet's publish settings. Used as a request body to set publish status.
  - `readOnlyFullAccessibleBy` 'ALL' | 'ORG' | 'SHARED' — Indicates who can access the 'Read-Only Full' view of the published sheet: * ALL - available to anyone who has the link. * ORG - available only to members of the sheet owner's Smartsheet organization account. * SHARED - available only to users shared to the item. Only returned in the response if `readOnlyFullEnabled = true`.
  - `readOnlyFullDefaultView` 'CALENDAR' | 'CARD' | 'GRID' — Indicates which view the user has set for a read-only, default view of the published sheet. Must be one of the listed enum values.
  - `readOnlyFullEnabled` boolean — If `true`, a rich version of the sheet is published with the ability to download row attachments and discussions.
  - `readOnlyFullShowToolbar` boolean — Indicates whether the left nav toolbar is displayed. The default, or **true**, is to display the toolbar. If `false`, hides the toolbar.
  - `readOnlyLiteEnabled` boolean — If `true`, a lightweight version of the sheet is published without row attachments and discussions.
  - `readWriteAccessibleBy` 'ALL' | 'ORG' | 'SHARED' — Indicates who can access the 'Edit by Anyone' view of the published sheet: * ALL - available to anyone who has the link. * ORG - available only to members of the sheet owner's Smartsheet organization account. * SHARED - available only to users shared to the item. Only returned in the response if `readWriteEnabled = true`.
  - `readWriteDefaultView` 'CALENDAR' | 'CARD' | 'GRID' — Indicates which view the user has set for a read-write, default view of the published sheet. Must be one of the listed enum values.
  - `readWriteEnabled` boolean — If `true`,a rich version of the sheet is published with the ability to edit cells and manage attachments and discussions.
  - `readWriteShowToolbar` boolean — Indicates whether the left nav toolbar is displayed. The default, or **true**, is to display the toolbar. If **false**, hides the toolbar.

## Response `200`

OK

- object
  - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.)
  - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation
  - `result` SheetPublish — Describes the sheet's publish settings. Used as a request body to set publish status.
    - `readOnlyFullAccessibleBy` 'ALL' | 'ORG' | 'SHARED' — Indicates who can access the 'Read-Only Full' view of the published sheet: * ALL - available to anyone who has the link. * ORG - available only to members of the sheet owner's Smartsheet organization account. * SHARED - available only to users shared to the item. Only returned in the response if `readOnlyFullEnabled = true`.
    - `readOnlyFullDefaultView` 'CALENDAR' | 'CARD' | 'GRID' — Indicates which view the user has set for a read-only, default view of the published sheet. Must be one of the listed enum values.
    - `readOnlyFullEnabled` boolean — If `true`, a rich version of the sheet is published with the ability to download row attachments and discussions.
    - `readOnlyFullShowToolbar` boolean — Indicates whether the left nav toolbar is displayed. The default, or **true**, is to display the toolbar. If `false`, hides the toolbar.
    - `readOnlyLiteEnabled` boolean — If `true`, a lightweight version of the sheet is published without row attachments and discussions.
    - `readWriteAccessibleBy` 'ALL' | 'ORG' | 'SHARED' — Indicates who can access the 'Edit by Anyone' view of the published sheet: * ALL - available to anyone who has the link. * ORG - available only to members of the sheet owner's Smartsheet organization account. * SHARED - available only to users shared to the item. Only returned in the response if `readWriteEnabled = true`.
    - `readWriteDefaultView` 'CALENDAR' | 'CARD' | 'GRID' — Indicates which view the user has set for a read-write, default view of the published sheet. Must be one of the listed enum values.
    - `readWriteEnabled` boolean — If `true`,a rich version of the sheet is published with the ability to edit cells and manage attachments and discussions.
    - `readWriteShowToolbar` boolean — Indicates whether the left nav toolbar is displayed. The default, or **true**, is to display the toolbar. If **false**, hides the toolbar.

## Other responses

- `default` — Generic Error Payload

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)