fix: close remaining gaps against the SIP Addresses spec doc

- context_id: document that it must reference an existing Domain in
  the project (previously undocumented, matches the 422
  invalid_parameter case in the source doc)
- user + context_id: document the domain+user uniqueness constraint
  (previously undocumented value_not_unique case)
- user: add a no-whitespace/non-blank pattern, covering the documented
  missing_required_parameter and format cases without attempting to
  encode full SIP userinfo grammar
- context (response): fix "account" vs "project" default-Domain
  wording inconsistency with context_id
- interface doc: note that SIP addresses are scoped to the caller's
  project (cross-project or non-SIP IDs return 404)

Author: Devon-White

fern/apis/signalwire-rest/openapi.yaml

@@ -42267,7 +42267,7 @@ components:
             - support-line
         context:
           type: string
-          description: The Domain this address is grouped under — for example, `public` for your account's default Domain.
+          description: The Domain this address is grouped under — for example, `public` for your project's default Domain.
           examples:
             - public
         uri:
@@ -42362,14 +42362,15 @@ components:
             - sales-line
         user:
           type: string
-          description: SIP username used to reach this address (no spaces). Defaults to `*`, which accepts any username.
+          pattern: ^\S+$
+          description: SIP username used to reach this address (no spaces). Defaults to `*`, which accepts any username. Together with the address's Domain, must be unique across your SignalWire account.
           examples:
             - agent
           default: '*'
         context_id:
           allOf:
             - $ref: '#/components/schemas/uuid'
-          description: ID of the Domain this address should be grouped under. Defaults to your project's default Domain.
+          description: ID of the Domain this address should be grouped under. Must exist in your project. Defaults to your project's default Domain.
           examples:
             - 9c8b7a6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d
         calling_handler_resource_id:
@@ -42548,13 +42549,14 @@ components:
             - renamed-line
         user:
           type: string
-          description: SIP username used to reach this address (no spaces).
+          pattern: ^\S+$
+          description: SIP username used to reach this address (no spaces). Together with the address's Domain, must be unique across your SignalWire account.
           examples:
             - agent
         context_id:
           allOf:
             - $ref: '#/components/schemas/uuid'
-          description: ID of the Domain this address should be grouped under. Defaults to the address's current Domain when omitted.
+          description: ID of the Domain this address should be grouped under. Must exist in your project. Defaults to the address's current Domain when omitted.
           examples:
             - 9c8b7a6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d
         ip_auth_enabled:

specs/signalwire-rest/fabric-api/sip-addresses/main.tsp

@@ -22,6 +22,9 @@ namespace SignalWireAPI.Fabric.SipAddresses {
     settings, IP authentication, and a resource that answers the calls it receives. Use this API to
     list, create, update, and delete SIP addresses without the dashboard.
 
+    This API only sees SIP addresses that belong to your project. An ID from another project, or an
+    ID that belongs to a different kind of address (for example, a video room), returns a 404.
+
     <Note>
     This is the public REST management API for standalone SIP addresses. It's separate from
     [Assign domain application handler](/docs/apis/rest/domain-applications/assign-domain-application-handler),

specs/signalwire-rest/fabric-api/sip-addresses/models/core.tsp

@@ -33,7 +33,7 @@ model SipAddress {
   @example("support-line")
   display_name: string;
 
-  @doc("The Domain this address is grouped under — for example, `public` for your account's default Domain.")
+  @doc("The Domain this address is grouped under — for example, `public` for your project's default Domain.")
   @example("public")
   context: string;
 

specs/signalwire-rest/fabric-api/sip-addresses/models/requests.tsp

@@ -9,11 +9,12 @@ model SipAddressCreateRequest {
   @pattern("^[a-z0-9]+(-[a-z0-9]+)*$")
   name: string;
 
-  @doc("SIP username used to reach this address (no spaces). Defaults to `*`, which accepts any username.")
+  @doc("SIP username used to reach this address (no spaces). Defaults to `*`, which accepts any username. Together with the address's Domain, must be unique across your SignalWire account.")
   @example("agent")
+  @pattern("^\\S+$")
   user?: string = "*";
 
-  @doc("ID of the Domain this address should be grouped under. Defaults to your project's default Domain.")
+  @doc("ID of the Domain this address should be grouped under. Must exist in your project. Defaults to your project's default Domain.")
   @example("9c8b7a6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d")
   context_id?: uuid;
 
@@ -62,11 +63,12 @@ model SipAddressUpdateRequest {
   @pattern("^[a-z0-9]+(-[a-z0-9]+)*$")
   name?: string;
 
-  @doc("SIP username used to reach this address (no spaces).")
+  @doc("SIP username used to reach this address (no spaces). Together with the address's Domain, must be unique across your SignalWire account.")
   @example("agent")
+  @pattern("^\\S+$")
   user?: string;
 
-  @doc("ID of the Domain this address should be grouped under. Defaults to the address's current Domain when omitted.")
+  @doc("ID of the Domain this address should be grouped under. Must exist in your project. Defaults to the address's current Domain when omitted.")
   @example("9c8b7a6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d")
   context_id?: uuid;