Skip to navigation
REST ClientFabricSubscribers

update

View as MarkdownOpen in Claude

Replace a subscriber resource. Uses PUT, so the full resource body must be provided.

Path parameters

idstringRequiredformat: "uuid"
Unique ID of a Subscriber.

Request

passwordstringOptional8-72 characters
New password for the Subscriber. Omit to keep the current password.
emailstringOptional
Email of the Subscriber.
first_namestringOptional
First name of the Subscriber.
last_namestringOptional
Last name of the Subscriber.
display_namestringOptional
Display name of the Subscriber.
job_titlestringOptional
Job title of the Subscriber.
time_zonestringOptional
Time zone of the Subscriber. Defaults to `GMT` if not provided.
countrystringOptional
Country of the Subscriber.
company_namestringOptional
Company name of the Subscriber.

Response

idstringRequired
Unique ID of the request.
project_idstringRequired
Unique ID of the project.
display_namestringRequired
Display name of the Subscriber.
typeenumRequired
Type of the resource.
Allowed values:
created_atdatetimeRequired
Date and time when the resource was created.
updated_atdatetimeRequired
Date and time when the resource was updated.
subscriberobjectRequired
Subscriber data.

Response Example

Response
{
  "id": "d369a402-7b43-4512-8735-9d5e1f387814",
  "project_id": "d369a402-7b43-4512-8735-9d5e1f387814",
  "display_name": "John Doe",
  "type": "subscriber",
  "created_at": "2024-05-06T12:20:00Z",
  "updated_at": "2024-05-06T12:20:00Z",
  "subscriber": {
    "id": "d369a402-7b43-4512-8735-9d5e1f387814",
    "email": "johndoe@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "display_name": "John Doe",
    "job_title": "Software Engineer",
    "time_zone": "America/New_York",
    "country": "United States",
    "company_name": "SignalWire"
  }
}

Example

from signalwire.rest import RestClient
client = RestClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
)
updated = client.fabric.subscribers.update("subscriber-id", name="bob")
print(f"Updated: {updated['display_name']}")