> ## 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 a ticket integration > Save this organization's credentials for one ticket system, one row per provider. Zoho Sprints authenticates with client_id, client_secret and refresh_token against auth_url; Jira with account_email and api_token. Only the fields you send change, an omitted secret keeps the stored one, and the board columns are mapped with set_ticket_status_map rather than here. ## OpenAPI ````yaml /api-reference/openapi.json put /ticket_integrations/{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: /ticket_integrations/{id}: put: tags: - ticket_integrations summary: Update a ticket integration description: >- Save this organization's credentials for one ticket system, one row per provider. Zoho Sprints authenticates with client_id, client_secret and refresh_token against auth_url; Jira with account_email and api_token. Only the fields you send change, an omitted secret keeps the stored one, and the board columns are mapped with set_ticket_status_map rather than here. operationId: updateTicketIntegration parameters: - description: The resource's provider. in: path name: id required: true schema: type: string requestBody: content: application/json: schema: properties: account_email: description: >- Jira only: the account the API token belongs to, as an email address. type: string api_token: description: >- Jira only: the API token that account authenticates with. Replaced and refused on the same terms as client_secret. format: password type: string writeOnly: true auth_url: description: >- Zoho Sprints only: the accounts server its access tokens are minted at, which is a different host from the API. type: string base_url: description: >- Where the API lives, per customer rather than a constant: Zoho serves seven data centres on seven domains and every Jira is its own host. Required the first time a provider is saved. type: string client_id: description: >- Zoho Sprints only: the self-client's id from the Zoho API console. type: string client_secret: description: >- Zoho Sprints only: the self-client's secret. Sending it replaces whatever is stored; an empty one is refused rather than read as a way to remove it. format: password type: string writeOnly: true create_project_id: description: 'Zoho Sprints only: the project a new item is filed into.' type: string create_sprint_id: description: 'Zoho Sprints only: the sprint a new item is filed into.' type: string create_team_id: description: >- Zoho Sprints only: the team a new item is filed into. Zoho addresses an item by three ids, so all three are needed to create one, or none of them. type: string enabled: description: >- Whether the platform may write into this system. Switched off, the credentials are kept and nothing is sent. type: boolean issue_type: description: >- Jira only: the issue type a new issue is filed as, for example Task. type: string project_key: description: >- Jira only: the project a new issue is filed into. Without it this connection can comment on an issue and not open one. type: string refresh_token: description: >- Zoho Sprints only: the long-lived token an access token is swapped for on every call. Replaced and refused on the same terms as client_secret. format: password type: string writeOnly: true 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.