> ## Documentation Index
> Fetch the complete documentation index at: https://jetemail.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update transactional API key

> Updates an existing transactional API key configuration or changes the status



## OpenAPI

````yaml /openapi.json patch /outbound/transactional-keys
openapi: 3.0.0
info:
  title: JetEmail API
  version: 1.0.0
  description: API documentation for JetEmail's transactional email service.
servers:
  - url: https://api.jetemail.com
    description: Production
security:
  - apiKeyAuth: []
externalDocs:
  description: Download OpenAPI Specification
  url: /openapi.json
paths:
  /outbound/transactional-keys:
    patch:
      tags:
        - Outbound
      summary: Update transactional API key
      description: >-
        Updates an existing transactional API key configuration or changes the
        status
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - api_token
              properties:
                api_token:
                  type: string
                  description: The API token to update
                  example: transactional_a1b2c3d4
                status:
                  type: integer
                  enum:
                    - 0
                    - 1
                  description: >-
                    Toggle key status (0 = disabled, 1 = enabled). If provided,
                    other update fields will be ignored.
                  example: 1
                name:
                  type: string
                  description: New name for the transactional key
                  example: Updated API Key
                  minLength: 1
                  maxLength: 64
                  pattern: ^[a-zA-Z0-9-_\s]+$
                allowAllDomains:
                  type: boolean
                  description: Whether to allow sending from all verified domains
                  example: false
                approvedDomains:
                  type: array
                  items:
                    type: string
                    pattern: >-
                      ^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?.)+[a-zA-Z]{2,}$
                  description: List of approved domains for sending
                  example:
                    - example.com
                    - mydomain.com
                  maxItems: 253
                quota:
                  type: integer
                  description: Email sending quota (0 for unlimited)
                  example: 1000
                  minimum: 0
                  maximum: 1000000
                ipRestrictions:
                  type: array
                  items:
                    type: string
                    pattern: >-
                      ^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)(?:/(?:3[0-2]|[12]?[0-9]))?)|(?:(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?|(?:[0-9a-fA-F]{1,4}:){1,7}:(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?|:(?::[0-9a-fA-F]{1,4}){1,7}(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?|::(?:/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9]))?)$
                  description: List of allowed IP addresses/CIDR ranges
                  example:
                    - 192.168.1.1
                    - 10.0.0.0/24
                  maxItems: 50
            examples:
              Toggle Disable:
                value:
                  api_token: transactional_a1b2c3d4
                  status: 0
                summary: Disable a key
              Toggle Enable:
                value:
                  api_token: transactional_a1b2c3d4
                  status: 1
                summary: Enable a key
              Update Name:
                value:
                  api_token: transactional_a1b2c3d4
                  name: New API Key Name
              Update Multiple Fields:
                value:
                  api_token: transactional_a1b2c3d4
                  name: Production API
                  allowAllDomains: true
                  approvedDomains:
                    - newdomain.com
                  quota: 5000
                  ipRestrictions:
                    - 192.168.1.100
                    - 10.0.0.0/24
      responses:
        '200':
          description: Transactional key updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Transactional key updated successfully
        '400':
          description: Bad Request - Invalid input
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Invalid name format
        '401':
          description: Unauthorized - User not authenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Required information not found
        '404':
          description: Not Found - Transactional key not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Transactional key not found or unauthorized
        '500':
          description: Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Failed to update transactional key
components:
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: API key for account management endpoints. Use your api_ prefixed token.

````