---
title: "SetTagPassword"
method: POST
path: "/kythene.v1.KytheneService/SetTagPassword"
tags: ["kythene.v1.KytheneService"]
---

# SetTagPassword

`POST /kythene.v1.KytheneService/SetTagPassword`

## Request

- Base URL: `https://kythene.com` (the document declares no server; this is the origin it was published from)
- URL: `https://kythene.com/kythene.v1.KytheneService/SetTagPassword`
- Auth: none required

SetTagPassword sets (or, with an empty password, clears) a tag's
 anonymous-view password: holders of the password can read that tag's
 collections at its public link without an account. Refuses internal tags and
 private projects. This is the password counterpart to a share code - the
 password admits anyone who has it; a share code admits one labelled holder.

## Headers

- `Connect-Protocol-Version` 1, required: Define the version of the Connect protocol
- `Connect-Timeout-Ms` number: Define the timeout, in ms

## Request body

- KytheneV1SetTagPasswordRequest
  - `tag` string: tag is the tag to set the password on - an id, or a name in the acting space.
  - `password` string: password is the secret anonymous viewers must enter to read the tag's collections. An EMPTY password CLEARS it (the tag stops admitting by password). A share code, if any, is a separate mechanism and is unaffected.
  - `space` string: space optionally selects which of your spaces to act in (an id or name from list_spaces). Omit it when you belong to a single space.

## Response `200`

Success

- KytheneV1SetTagPasswordResponse
  - `tag` KytheneV1Tag
    - `id` string
    - `name` string
    - `isInternal` boolean
    - `hasPassword` boolean

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/kythene/apis/kythene-v1.md) · [All operations](https://skmtc.dev/kythene/apis/kythene-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/kythene/apis/kythene-v1/revisions/5a768e642d10?raw)