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

# Reschedule a Pending Scheduled SMS Message



## OpenAPI

````yaml https://ugatext.com/api/v1/openapi.json post /sms/schedule/{id}/reschedule
openapi: 3.0.3
info:
  title: UgaText Developer Communications API
  version: 1.0.0
  description: >-
    Official REST API for UgaText (https://ugatext.com/api/v1). Supports single
    and bulk SMS dispatch across Uganda (+256 via Pandora), Kenya (+254 via Ping
    Africa), Tanzania (+255 via SwalaSMS), and DR Congo (+243 via Coussema SMS
    Gateway), real-time queued → sent → delivered status polling, SMS scheduling
    with recurrence (none, daily, weekly, monthly), bulk campaigns, wallet
    balance queries, Sender ID lifecycle management, opt-out management,
    HMAC-SHA256 webhooks, UCC 21-rule compliance inspection, and OTP
    verification. Rate limit: 600 requests/minute (10 req/sec). Free sandbox
    numbers: +256700000000, +254700000000, +255700000000, or +243810000000.
  contact:
    name: UgaText Developer Support
    url: https://docs.ugatext.com
    email: support@ugatext.com
servers:
  - url: https://ugatext.com/api/v1
    description: UgaText Production API Gateway
security:
  - ClientIdHeader: []
    ClientSecretHeader: []
tags:
  - name: System
    description: Gateway health, route index, and OpenAPI specification
  - name: Authentication
    description: API key verification, generation, configuration, and revocation
  - name: SMS
    description: Single and bulk SMS dispatch, status polling, history, and wallet balance
  - name: Scheduling
    description: Future SMS scheduling, recurrence, rescheduling, and cancellation
  - name: Campaigns
    description: Bulk SMS campaign creation, listing, details, and cancellation
  - name: Verify
    description: OTP verification sessions, services/apps, and analytics
  - name: Sender IDs
    description: >-
      Alphanumeric Sender ID registration, regulatory documents, wallet payment,
      and lifecycle
  - name: Webhooks
    description: Real-time HMAC-SHA256 delivery receipt webhooks and test dispatch
  - name: Opt-Outs
    description: Recipient opt-out suppression list management
  - name: Compliance
    description: Pre-flight 21-rule UCC SMS compliance and GSM segmentation inspection
paths:
  /sms/schedule/{id}/reschedule:
    post:
      tags:
        - Scheduling
      summary: Reschedule a Pending Scheduled SMS Message
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            example: sched_1760425200000_1a2b3c4d
          description: The scheduled message ID to reschedule
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RescheduleSMSRequest'
      responses:
        '200':
          description: Scheduled message rescheduled successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduleSMSResponse'
        '400':
          description: INVALID_REQUEST or INVALID_SCHEDULE_TIME
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: INVALID_API_KEY (missing, invalid, or revoked credentials)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: NOT_FOUND
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: RATE_LIMIT_EXCEEDED (600 requests/minute limit exceeded)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ClientIdHeader: []
          ClientSecretHeader: []
components:
  schemas:
    RescheduleSMSRequest:
      type: object
      required:
        - scheduled_at
      properties:
        scheduled_at:
          type: string
          format: date-time
          description: 'New future ISO-8601 timestamp (accepted alias: "scheduledAt").'
          example: '2026-12-02T09:00:00.000Z'
        recurrence:
          type: string
          enum:
            - none
            - daily
            - weekly
            - monthly
          description: >-
            Optional updated repeat interval ("none", "daily", "weekly", or
            "monthly"). Preserves existing recurrence when omitted.
        message:
          type: string
          description: Optional updated SMS message text.
    ScheduleSMSResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message_id:
          type: string
          example: sched_1760425200000_1a2b3c4d
        status:
          type: string
          example: scheduled
        recipient:
          type: string
          example: '+256700000000'
        sender_id:
          type: string
          example: UGATEXT
        scheduled_at:
          type: string
          format: date-time
        recurrence:
          type: string
          enum:
            - none
            - daily
            - weekly
            - monthly
          example: none
        segments:
          type: integer
          example: 1
        cost_units:
          type: integer
          example: 0
        estimated_cost_ugx:
          type: number
          example: 0
        cost_ugx:
          type: number
          example: 0
        currency:
          type: string
          example: UGX
        mode:
          type: string
          enum:
            - live
            - sandbox
          example: sandbox
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          example: false
        retry_after_seconds:
          type: integer
          description: >-
            Seconds to wait before retrying when rate-limited or during an
            active OTP resend cooldown (HTTP 429).
          example: 60
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: INVALID_REQUEST
            message:
              type: string
              example: >-
                Authentication failed. Provide a valid 'Client-ID' and
                'Client-Secret' in the request headers.
            retry_after_seconds:
              type: integer
              description: >-
                Seconds remaining before another OTP or rate-limited request is
                permitted (present on 429 COOLDOWN_ACTIVE and rate-limit
                errors).
              example: 60
  securitySchemes:
    ClientIdHeader:
      type: apiKey
      in: header
      name: Client-ID
      description: >-
        Your UgaText Client-ID (e.g. uga_...). Accepted header aliases:
        X-Client-ID, or combined in Authorization: Bearer
        <Client-ID>:<Client-Secret> / X-API-Key: <Client-ID>:<Client-Secret>.
    ClientSecretHeader:
      type: apiKey
      in: header
      name: Client-Secret
      description: >-
        Your UgaText Client-Secret (e.g. sk_live_...). Accepted header alias:
        X-Client-Secret.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.