> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes. # update > Update the project SIP profile. Update the project SIP profile. Uses PUT for full replacement. ### Schema ```yaml openapi: 3.1.0 info: title: API version: 1.0.0 paths: /api/relay/rest/sip_profile: put: operationId: subpackageSipProfile_update_sip_profile summary: Update SIP profile description: >- Changes the project-wide defaults that SIP Credentials use for registration, media, security, and outbound calling. This updates the project's single SIP Profile; it does not create or update an individual [SIP Credential](/docs/apis/rest/sip-credentials/update-sip-credential) or [SIP Gateway](/docs/apis/rest/sip-gateway/update-sip-gateway). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). tags: - subpackage_sipProfile responses: '201': description: >- The request has succeeded and a new resource has been created as a result. content: application/json: schema: $ref: '#/components/schemas/SipProfileResponse' '401': description: Access is unauthorized. content: application/json: schema: $ref: '#/components/schemas/Types.StatusCodes.StatusCode401' '422': description: The request failed validation. See errors for details. content: application/json: schema: $ref: '#/components/schemas/Types.StatusCodes.ValidationError' '500': description: An internal server error occurred. content: application/json: schema: $ref: '#/components/schemas/Types.StatusCodes.StatusCode500' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateSipProfileRequest' tags: - name: subpackage_sipProfile servers: - url: https://%7BYour_Space_Name%7D.signalwire.com description: SignalWire API components: schemas: UpdateSipProfileRequestDefaultEncryption: type: string enum: - required - optional description: >- A string representing whether connections to an endpoint that uses this profile require encryption or if encryption is optional. Encryption will always be used if possible. Possible values are required or optional. title: UpdateSipProfileRequestDefaultEncryption UpdateSipProfileRequest: type: object properties: domain_identifier: type: string description: >- String representing the domain_identifier portion of the profile. Must be unique across your project. default_codecs: type: array items: type: string description: >- A list of codecs this profile will support. Currently supported values are: OPUS, G722, PCMU, PCMA, VP8, H264. default_ciphers: type: array items: type: string description: >- A list of encryption ciphers this profile will support. Currently supported values are: AEAD_AES_256_GCM_8, AES_256_CM_HMAC_SHA1_80, AES_CM_128_HMAC_SHA1_80, AES_256_CM_HMAC_SHA1_32, AES_CM_128_HMAC_SHA1_32. default_encryption: $ref: '#/components/schemas/UpdateSipProfileRequestDefaultEncryption' description: >- A string representing whether connections to an endpoint that uses this profile require encryption or if encryption is optional. Encryption will always be used if possible. Possible values are required or optional. default_send_as: type: string description: >- The e164 formatted number you wish to set as the originating number when dialing PSTN phone numbers from a SIP Endpoint that uses this profile. Specify null or an empty string to randomly choose a purchased or verified number from within the project. description: Request body for updating the SIP profile. title: UpdateSipProfileRequest SipProfileResponseDefaultEncryption: type: string enum: - required - optional description: >- A string representing whether connections to an endpoint that uses this profile require encryption or if encryption is optional. Encryption will always be used if possible. Possible values are required or optional. title: SipProfileResponseDefaultEncryption SipProfileResponse: type: object properties: domain: type: string description: >- A string representation of the fully qualified domain name for this profile. domain_identifier: type: string description: >- String representing the domain_identifier portion of the profile. Must be unique across your project. default_codecs: type: array items: type: string description: >- A list of codecs this profile will support. Currently supported values are: OPUS, G722, PCMU, PCMA, VP8, H264. default_ciphers: type: array items: type: string description: >- A list of encryption ciphers this profile will support. Currently supported values are: AEAD_AES_256_GCM_8, AES_256_CM_HMAC_SHA1_80, AES_CM_128_HMAC_SHA1_80, AES_256_CM_HMAC_SHA1_32, AES_CM_128_HMAC_SHA1_32. default_encryption: $ref: '#/components/schemas/SipProfileResponseDefaultEncryption' description: >- A string representing whether connections to an endpoint that uses this profile require encryption or if encryption is optional. Encryption will always be used if possible. Possible values are required or optional. default_send_as: type: string description: >- The e164 formatted number you wish to set as the originating number when dialing PSTN phone numbers from a SIP Endpoint that uses this profile. Specify null or an empty string to randomly choose a purchased or verified number from within the project. description: Response containing the SIP profile. title: SipProfileResponse TypesStatusCodesStatusCode401Error: type: string enum: - Unauthorized title: TypesStatusCodesStatusCode401Error Types.StatusCodes.StatusCode401: type: object properties: error: $ref: '#/components/schemas/TypesStatusCodesStatusCode401Error' required: - error description: Access is unauthorized. title: Types.StatusCodes.StatusCode401 Types.StatusCodes.SpaceApiErrorItem: type: object properties: detail: type: string description: A description of what caused the error. status: type: string description: The HTTP status code. title: type: string description: A short summary of the error type. code: type: string description: The error code. required: - detail - status - title - code description: Details about a specific validation error. title: Types.StatusCodes.SpaceApiErrorItem Types.StatusCodes.ValidationError: type: object properties: errors: type: array items: $ref: '#/components/schemas/Types.StatusCodes.SpaceApiErrorItem' description: List of validation errors. required: - errors description: The request failed validation. See errors for details. title: Types.StatusCodes.ValidationError TypesStatusCodesStatusCode500Error: type: string enum: - Internal Server Error title: TypesStatusCodesStatusCode500Error Types.StatusCodes.StatusCode500: type: object properties: error: $ref: '#/components/schemas/TypesStatusCodesStatusCode500Error' required: - error description: An internal server error occurred. title: Types.StatusCodes.StatusCode500 ``` ## **Response Example** ### Response (201) ```json { "domain": "your-space-example.sip.signalwire.com", "domain_identifier": "example", "default_codecs": [ "string" ], "default_ciphers": [ "string" ], "default_encryption": "optional", "default_send_as": "+15551234567" } ``` ## **Example** ```typescript {4} import { RestClient } from "@signalwire/sdk"; const client = new RestClient(); const result = await client.sipProfile.update({ default_codecs: ['PCMU', 'PCMA'] }); console.log(result); ``` > Update the project SIP profile.