> ## Documentation Index > Fetch the complete documentation index at: https://docs.sreagent.app/llms.txt > Use this file to discover all available pages before exploring further. # Update an outbound config > Change one target, named by the id list_outbound_configs reports; omitted fields keep their value. An omitted api_key or routing_key keeps the stored token, and an empty one is refused rather than read as a way to remove it. ## OpenAPI ````yaml /api-reference/openapi.json put /outbound_configs/{id} openapi: 3.1.0 info: description: >- A resource-shaped endpoint onto the same tool surface the MCP server (/api/mcp) reaches. Every gate, refusal and audit row a caller sees here is the exact one the MCP endpoint answers for the same tool. Authenticated with an API key holding the api:admin scope, or the read-only api:config_read scope for GET alone. title: SRE Agent configuration API version: 1.0.0 servers: - url: https://sreagent.app/api/v1/config security: - apiKey: [] tags: - name: ai_providers - name: ai_settings - name: alert_mutes - name: alert_routes - name: aws_external_id - name: certificate_monitors - name: change_notifications - name: compliance_periods - name: connectors - name: data_sources - name: deploy_policies - name: export - name: github_settings - name: image_targets - name: notification_settings - name: organization_settings - name: outbound_configs - name: outbound_rules - name: overseer_settings - name: prompt_templates - name: repo_settings - name: service_bindings - name: slack - name: slis - name: slos - name: status_page_components - name: status_page_incidents - name: status_page_settings - name: synthetic_checks - name: team_members - name: teams - name: ticket_import_rules - name: ticket_integrations paths: /outbound_configs/{id}: put: tags: - outbound_configs summary: Update an outbound config description: >- Change one target, named by the id list_outbound_configs reports; omitted fields keep their value. An omitted api_key or routing_key keeps the stored token, and an empty one is refused rather than read as a way to remove it. operationId: update_outbound_config parameters: - description: The resource's id. in: path name: id required: true schema: type: string requestBody: content: application/json: schema: properties: api_key: description: >- The bearer token for a webhook or a Grafana target. Write-only: it is never answered by any tool here, an omitted one keeps the stored token, and an empty one is refused rather than read as a way to remove it. To remove it, delete the target. format: password type: string writeOnly: true base_url: description: >- Where to send the calls: the endpoint for a webhook target, the Grafana instance for a Grafana one. PagerDuty does not use it. null clears it. type: - string - 'null' default_severity_mapping: description: >- What each of this platform's severities is called at the provider, for PagerDuty. A severity this does not name uses the built-in mapping, and null means every one of them does. type: - object - 'null' enabled: description: >- Whether this target may be escalated to at all. A disabled row keeps its tokens and its rules and is skipped. type: boolean name: description: >- What this target is called here, unique within the organization. It is a label for the people reading the list, not anything the provider sees. type: string oncall_schedule_id: description: >- The schedule (by its uuid, as list_oncall_schedules answers it) an oncall_schedule target pages. It must belong to this organization. Required while provider_type is oncall_schedule and refused for every other provider, on the same terms as slack_channel: who is paged is resolved fresh from this schedule's roster and overrides at the moment of each page (Slack DM when the person on call has a linked account, email otherwise), never cached, and a schedule with nobody currently on call is a failed page rather than a silent one. type: - string - 'null' priority: description: >- The order this organization's targets are tried in, lowest first. At least 1. type: integer provider_type: description: >- Which system this target reaches: pagerduty, grafana, webhook, slack, oncall_schedule. enum: - pagerduty - grafana - webhook - slack - oncall_schedule type: string routing_key: description: >- The PagerDuty Events integration key. Write-only on the same terms as api_key, which PagerDuty falls back to when this is not set. format: password type: string writeOnly: true slack_channel: description: >- The channel a Slack target's pages open in, like #oncall. Required while provider_type is slack and refused for every other provider, so the channel cannot be removed on a Slack target: converting the target to another provider_type is what clears it, and the stored channel goes with that conversion. The target pages in this organization's own connected workspace: no token is stored here, and an acknowledged or resolved alert rewrites the page it already posted rather than adding a message. type: - string - 'null' required: [] type: object required: false responses: '200': description: Updated. '201': description: Created (an upsert resource's PUT on a missing row). '404': description: No such resource. '412': description: If-Match named a version of the row that is no longer current. '422': description: The tool refused the request's shape or content. default: description: The request failed. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Error: type: object description: The body of every failed request. properties: error: type: string description: >- A short machine-readable code such as forbidden, conflict or read_only_key. message: type: string description: A sentence that says what to change. required: - error - message additionalProperties: true securitySchemes: apiKey: description: >- An sre_ak_* API key holding the api:admin scope (or api:config_read, which every write refuses with read_only_key). scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.