---
title: "Update enterprise listing"
method: PUT
path: "/api/address-book/v1/listing/{listingId}"
tags: ["Counterparties"]
---

# Update enterprise listing

`PUT /api/address-book/v1/listing/{listingId}`

You can update the following:
* Description of your enterprise listing.
* Description of the target listing on connections you added from the directory.
* Description and or name of the target listing name from connections you directly added by wallet ID.

**Requires access token scope:** `wallet_spend_all`

## Path parameters

- `listingId` string, required

## Headers

- `enterprise-id` string, required
- `user-id` string, required

## Request body

- object
  - `description` string — Description is always updatable
  - `name` string — The name of your listing that displays in the global directory. `editable` must be `true`

## Response `200`

OK

- V1ListingUpdateResponse
  - `id` string, required
  - `enterpriseId` string
  - `description` string
  - `name` string, required
  - `owner` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `globalListing` object — codec for global listing http response
    - `createdAt` string, date-time, required
    - `description` string
    - `enterpriseId` string, required
    - `id` string, required
    - `name` string, required
    - `owner` string, required
    - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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