---
title: "Set integration visibility"
method: PUT
path: "/v1/integrations/{id}/visibility"
tags: ["integrations"]
---

# Set integration visibility

`PUT /v1/integrations/{id}/visibility`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/integrations/{id}/visibility`
- Auth: HTTP bearer

Make your tools in an integration public or private.

- A Business team's integrations start private, and the team makes them public or private again. An Owner or Admin changes every tool your team created there; a member changes only their own. Other accounts' tools in a public integration stay public.
- A Personal account's owner makes public an integration Pomerado kept private, but not private again. Pomerado first checks that no tool there holds your own email address or name, or a credential, and refuses it if one does.
- A tool that signs in outside its website, which its owner approved, stays private to the owner's account, so an integration holding one isn't made public.
- The tools may join the site's existing integration of that visibility, so the response names the integration that now holds them.

## Path parameters

- `id` string, required

## Request body

- object
  - `visibility` 'public' | 'private', required: public: published on Pomerado for every account to find and use. private: only your team sees, uses and edits it

## Response `200`

The integration that now holds your tools, and its visibility

- IntegrationVisibility
  - `id` string, required: an integration ID: int_ and 32 lowercase hex digits
  - `visibility` 'public' | 'private', required: public: published on Pomerado for every account to find and use. private: only your team sees, uses and edits it

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: business_account_required, forbidden
- `404`: not_found
- `409`: integration_tool_name_taken, unchecked_version, tool_signs_in_outside_site, tool_holds_owner_data, integration_too_large_to_check, tool_code_missing
- `413`: request_too_large
- `500`: internal_error
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/48dac2a3143e?raw)