---
title: "Update short code"
method: PATCH
path: "/short_codes/{id}"
tags: ["Short Codes"]
---

# Update short code

`PATCH /short_codes/{id}`

Update the settings for a specific short code. To unbind a short code from a profile, set the `messaging_profile_id` to `null` or an empty string.
To add or update tags, include the tags field as an array of strings.

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateShortCodeRequest
  - `messaging_profile_id` string, required — Unique identifier for a messaging profile.
  - `tags` string[] — Tags associated with the resource.

## Response `200`

Successful response with details about a short code.

- object
  - `data` ShortCode
    - `record_type` 'short_code' — Identifies the type of the resource.
    - `id` string, uuid — Identifies the type of resource.
    - `short_code` string — Short digit sequence used to address messages.
    - `country_code` string — ISO 3166-1 alpha-2 country code.
    - `messaging_profile_id` string, nullable, required — Unique identifier for a messaging profile.
    - `tags` string[] — Tags associated with the resource.
    - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was updated.

## Other responses

- `4XX` — Unexpected error

---

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