> ## Documentation Index
> Fetch the complete documentation index at: https://claimsdesk-871aefc7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Advances a workflow stage instance to the next step.



## OpenAPI

````yaml POST /api/v1/WorkflowInstances/{id}/transition
openapi: 3.0.4
info:
  title: ClaimsDesk API v1.0
  description: Core claims engine and workflow endpoints.
  version: '1.0'
servers:
  - url: http://claimsdesk.runasp.net
    description: Production / Demo Server
security:
  - AppId: []
    ApiKey: []
tags:
  - name: Auth
    x-group: Authentication & Session
    description: >-
      User login, customer authentication, session profile, and Multi-Factor
      Authentication (2FA).
  - name: Claims
    x-group: Claims Processing
    description: >-
      Core claims engine: FNOL submission, claim review, adjustments, status
      progression, and cancellation.
  - name: Workflows
    x-group: Workflow Engine
    description: >-
      Workflow definitions, process stages, approval transitions, and rule
      cloning.
  - name: WorkflowInstances
    x-group: Workflow Engine
    description: >-
      Runtime workflow tracking, stage progression, pause/resume controls, and
      execution trace logs.
  - name: Policies
    x-group: Insurance & Underwriting
    description: >-
      Policy management, terms, coverage limits, and claim entitlement
      verification.
  - name: PolicyContributions
    x-group: Insurance & Underwriting
    description: Policy premium contributions, payment logs, and transaction receipts.
  - name: Customers
    x-group: Policyholders & Members
    description: Customer master records and policyholder profiles.
  - name: Members
    x-group: Policyholders & Members
    description: Covered members, dependents, and beneficiary allocations.
  - name: Organizations
    x-group: Tenant & Multi-Branch
    description: Corporate clients and tenant organizations.
  - name: Branches
    x-group: Tenant & Multi-Branch
    description: Branch offices and organizational operational units.
  - name: Users
    x-group: User & Access Management
    description: Staff user administration, approval limits, and branch assignments.
  - name: Roles
    x-group: User & Access Management
    description: Role definitions and system authorization tiers.
  - name: Permissions
    x-group: User & Access Management
    description: Platform feature permissions and operational entitlements.
  - name: RolePermissions
    x-group: User & Access Management
    description: Role-to-permission mapping and capability matrices.
  - name: Subscriptions
    x-group: Subscriptions & Licensing
    description: Tenant subscription plans, billing tiers, and validity windows.
  - name: LicensePools
    x-group: Subscriptions & Licensing
    description: License pool quota allocations and seat provisioning.
  - name: UserLicenses
    x-group: Subscriptions & Licensing
    description: User license seat assignments and activation keys.
  - name: Notifications
    x-group: Communications & Messaging
    description: In-app notifications inbox, unread counts, batch marks, and cleanup.
  - name: Emails
    x-group: Communications & Messaging
    description: Transactional email delivery, recipient dispatch, and SMTP audit history.
  - name: Sms
    x-group: Communications & Messaging
    description: >-
      SMS gateway dispatch (Africa's Talking), delivery receipts, and messaging
      logs.
  - name: Reports
    x-group: Analytics & Reporting
    description: >-
      Analytics engine, live report preview, batch generation, and PDF/CSV
      export.
  - name: Settings
    x-group: Configuration & Preferences
    description: System configurations, preferences, and batch setting updates.
  - name: ApiKeys
    x-group: Developer & Security
    description: Tenant integration keys and machine-to-machine authentication tokens.
  - name: AuditTrails
    x-group: Developer & Security
    description: >-
      Comprehensive audit logs, activity tracing, and regulatory compliance
      records.
  - name: Payments
    x-group: Payments & M-Pesa
    description: >-
      M-Pesa Daraja integration: STK Push (Lipa Na M-Pesa Online), B2C Claim
      Settlement Disbursement, Webhooks, and Transaction Tracking.
paths:
  /api/v1/WorkflowInstances/{id}/transition:
    post:
      tags:
        - WorkflowInstances
      summary: Advances a workflow stage instance to the next step.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              $ref: 42e74de4-024a-481d-b600-9ee640347187
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    AppId:
      type: apiKey
      description: App ID authentication. Enter your App ID below.
      name: X-App-Id
      in: header
    ApiKey:
      type: apiKey
      description: API Key authentication. Enter your key below.
      name: X-Api-Key
      in: header

````

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