---
title: "Share one of this artifact's tables with the workspace (Teams)"
method: POST
path: "/v1/data/{artifactId}/workspace/_share"
tags: ["Data"]
---

# Share one of this artifact's tables with the workspace (Teams)

`POST /v1/data/{artifactId}/workspace/_share`

Owner-only. Exposes one of this artifact's tables to other artifacts in the same workspace at read or readwrite level. The data stays in this artifact's store; this only records an opt-in grant.

## Request body

- object
  - `table` string, required — Name of this artifact's table to share.
  - `as` string — Workspace-unique shared name (defaults to the table name).
  - `access` 'read' | 'readwrite'

## Response `200`

Share created or updated

## Other responses

- `403` — Access denied

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/revisions/804359ead65a/schema)