> ## Documentation Index > Fetch the complete documentation index at: https://blackbox.dasha.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update SIP credential > Updates an existing SIP credential configuration. This is a full replacement operation (PUT) that updates all credential settings including server address, authentication details, and transport protocol. ## Automatic Updates When you update SIP credentials, all phone numbers associated with these credentials automatically use the updated authentication settings for all future calls. No additional configuration is required. Credentials managed by a VoIP provider (such as Twilio) are read-only and cannot be modified. To remove provider-managed credentials, delete the provider integration instead. ## OpenAPI ````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json put /api/v1/sip-credentials/{id} openapi: 3.0.4 info: title: Dasha BlackBox Agent API description: API for managing AI agents and calls contact: name: DashaAI Team email: support@dasha.ai version: v1 servers: - url: https://blackbox.dasha.ai description: Dasha BlackBox Agent API security: - ApiKey: [] - OAuth: [] tags: - name: ActivityLogs - name: Agents - name: AgentTestCases - name: CallResults - name: Calls - name: Chats - name: Copilot - name: CustomerData - name: Mcp - name: Media - name: Misc - name: PronunciationDictionaries - name: Providers - name: SipAliases - name: SipCredentials - name: SipPhoneNumbers - name: TextChat - name: TwilioProvider - name: Voice - name: WebhookTest - name: WebIntegrations - name: WebSocket description: WebSocket endpoints for real-time communication paths: /api/v1/sip-credentials/{id}: put: tags: - SipCredentials summary: Update SIP credential description: >- Updates an existing SIP credential configuration. This is a full replacement operation (PUT) that updates all credential settings including server address, authentication details, and transport protocol. parameters: - name: id in: path description: Credential identifier required: true schema: type: string format: uuid requestBody: description: SIP credential configuration content: application/json: schema: allOf: - $ref: '#/components/schemas/SipCredentialsRequestDto' description: >- Configuration for creating or updating SIP trunk credentials. SIP credentials define how to connect to your SIP provider for making and receiving phone calls, including server address, authentication, transport protocol, and rate limiting settings. text/json: schema: allOf: - $ref: '#/components/schemas/SipCredentialsRequestDto' description: >- Configuration for creating or updating SIP trunk credentials. SIP credentials define how to connect to your SIP provider for making and receiving phone calls, including server address, authentication, transport protocol, and rate limiting settings. application/*+json: schema: allOf: - $ref: '#/components/schemas/SipCredentialsRequestDto' description: >- Configuration for creating or updating SIP trunk credentials. SIP credentials define how to connect to your SIP provider for making and receiving phone calls, including server address, authentication, transport protocol, and rate limiting settings. responses: '200': description: SIP credential updated successfully content: application/json: schema: $ref: '#/components/schemas/SipCredentialsResponseDto' '400': description: Invalid configuration or validation errors content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: Authentication failed or API key is missing content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '403': description: Cannot modify credentials managed by provider content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '404': description: SIP credential with specified ID does not exist content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '409': description: Update conflict occurred content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '500': description: Server error occurred during SIP credential update components: schemas: SipCredentialsRequestDto: required: - server type: object properties: domain: maxLength: 255 type: string description: >- SIP domain for authentication realm as defined in RFC 3261. Used by some SIP providers as the authentication domain. When not specified, the server address is typically used as the domain. default: null nullable: true server: maxLength: 255 minLength: 1 type: string description: >- SIP server hostname or IP address with optional port, following RFC 3261 specifications. Specifies where to send SIP registration and call signaling. Include port number if using non-standard ports. authUser: maxLength: 255 type: string description: >- Authentication user identifier as defined in RFC 3261. Provided by your SIP trunk provider for authentication. Different providers may call this "username", "account", "user ID", or other names. May differ from the phone number used for caller ID. default: null nullable: true authPassword: maxLength: 64 type: string description: >- Password for SIP authentication as defined in RFC 3261. Provided by your SIP trunk provider along with the username. default: null nullable: true transport: allOf: - $ref: '#/components/schemas/TransportProtocol' description: >- Transport protocol for SIP signaling. Supported values: UDP (fastest, most common), TCP (more reliable), TLS (encrypted). Defaults to UDP when not specified. Choose based on your SIP provider's requirements and security needs. default: udp nullable: true description: maxLength: 255 type: string description: >- Human-readable description of these credentials. Useful for identifying which SIP provider or trunk these credentials represent, such as "Primary Twilio Trunk" or "Backup SIP Provider". default: null nullable: true cpsLimit: type: number description: >- Maximum calls per second allowed through this SIP trunk. Used to prevent exceeding your SIP provider's rate limits or to control call pacing. When specified, the system throttles outbound call attempts to stay within this limit. format: float default: null nullable: true cpsKey: maxLength: 255 type: string description: >- Shared rate limiting key for grouping multiple credentials under a common CPS limit. When multiple SIP credentials share the same CpsKey, their combined call rate is limited by the CpsLimit. Useful when you have multiple trunks from the same provider with a shared rate limit. default: null nullable: true additionalProperties: false description: >- Configuration for creating or updating SIP trunk credentials. SIP credentials define how to connect to your SIP provider for making and receiving phone calls, including server address, authentication, transport protocol, and rate limiting settings. SipCredentialsResponseDto: required: - createdTime - id - lastUpdateTime - orgId - server - source - transport type: object properties: id: type: string description: >- Unique identifier for these SIP credentials. Use this ID when configuring phone numbers or referencing these credentials in agent configurations. format: uuid orgId: minLength: 1 type: string description: >- Organization that owns these SIP credentials. Used for access control and resource isolation. domain: type: string description: >- SIP domain for authentication realm as defined in RFC 3261. Used by some SIP providers as the authentication domain. nullable: true server: minLength: 1 type: string description: >- SIP server hostname or IP address with optional port, following RFC 3261 specifications. Specifies where to send SIP registration and call signaling. authUser: type: string description: >- Authentication user identifier as defined in RFC 3261. Different providers may call this "username", "account", "user ID", or other names. nullable: true authPassword: type: string description: Password for SIP authentication as defined in RFC 3261. nullable: true transport: allOf: - $ref: '#/components/schemas/TransportProtocol' description: >- Transport protocol used for SIP signaling. Indicates whether this trunk uses UDP, TCP, or TLS for communication. description: type: string description: >- Human-readable description of these credentials. Helps identify which SIP provider or trunk these credentials represent. nullable: true cpsLimit: type: integer description: >- Maximum calls per second allowed through this SIP trunk. Controls call pacing to prevent exceeding provider rate limits. format: int32 nullable: true cpsKey: type: string description: >- Shared rate limiting key for grouping multiple credentials under a common CPS limit. When set, multiple trunks with the same key share the rate limit. nullable: true source: allOf: - $ref: '#/components/schemas/CredentialSource' description: >- Indicates how these credentials were created. 'manual' means user-entered credentials, 'provider' means automatically configured by a connected VoIP provider integration (such as Twilio). providerId: type: string description: >- Reference to the VoIP provider that manages these credentials. Present only for provider-managed credentials where Source is 'provider'. When present, the provider handles credential lifecycle and configuration. format: uuid nullable: true createdTime: type: string description: Timestamp when these credentials were originally created. format: date-time lastUpdateTime: type: string description: >- Timestamp when these credentials were last modified. Updates when configuration changes are made. format: date-time additionalProperties: false description: >- SIP trunk credentials information including connection settings, authentication, rate limiting, and metadata. Contains all configuration needed to connect to a SIP provider for making and receiving calls. ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true additionalProperties: {} TransportProtocol: enum: - udp - tcp - tls type: string description: >- Transport protocol for SIP communication. Defines how SIP messages are transmitted over the network. CredentialSource: enum: - manual - provider type: string description: >- Source of provider credentials. Indicates how the credentials were obtained and configured. securitySchemes: ApiKey: type: http description: API Key Authentication (Bearer {key}) scheme: Bearer OAuth: type: oauth2 flows: implicit: authorizationUrl: https://auth.dasha.ai/connect/authorize scopes: platform_api: Platform API ````