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

# Re-run the pipeline

> Re-runs the KYB verification pipeline for an already-submitted case WITHOUT re-entering the form. Unlocks the stored field values, drops the verification link so the engine creates a fresh run, then re-submits (re-locks fields, under_review, emits kyb_case.submitted). The stored form data is untouched. A re-run re-screens against live providers (Cobalt / IRS / AML) and mints a NEW verification. The case is addressed by its id and scoped to the caller's organization (the API key's tenant); an id in another org returns 404.



## OpenAPI

````yaml https://api.dataspike.io/openapi/kyb/public.json post /api/v4/kyb/cases/{caseId}/rerun
openapi: 3.1.0
info:
  description: Know Your Business (KYB) — case creation and the embedded onboarding widget.
  title: Dataspike KYB API
  version: '1.0'
servers: []
security: []
paths:
  /api/v4/kyb/cases/{caseId}/rerun:
    post:
      tags:
        - KYB Cases
      summary: Re-run the pipeline
      description: >-
        Re-runs the KYB verification pipeline for an already-submitted case
        WITHOUT re-entering the form. Unlocks the stored field values, drops the
        verification link so the engine creates a fresh run, then re-submits
        (re-locks fields, under_review, emits kyb_case.submitted). The stored
        form data is untouched. A re-run re-screens against live providers
        (Cobalt / IRS / AML) and mints a NEW verification. The case is addressed
        by its id and scoped to the caller's organization (the API key's
        tenant); an id in another org returns 404.
      operationId: POST_/api/v4/kyb/cases/:caseId/rerun
      parameters:
        - description: KYB case id.
          in: path
          name: caseId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: d5293a33-1d10-4aa2-8ff9-4a2c9a2d1e19
            application/xml:
              schema:
                $ref: d5293a33-1d10-4aa2-8ff9-4a2c9a2d1e19
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrCaseNotFound'
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrCaseNotFound'
          description: Case not found.
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrCaseNotSubmitted'
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrCaseNotSubmitted'
          description: Case has not been submitted yet (nothing to re-run).
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
          description: Pipeline re-run; case back under_review.
      security:
        - ApiKey: []
components:
  schemas:
    ErrCaseNotFound:
      description: ErrCaseNotFound schema
      example:
        code: case_not_found
        message: Case not found
      properties:
        code:
          example: email_otp_expired
          type: string
        message:
          example: OTP has expired
          type: string
        param:
          nullable: true
          type: string
      type: object
    ErrCaseNotSubmitted:
      description: ErrCaseNotSubmitted schema
      example:
        code: case_not_submitted
        message: Case has not been submitted yet
      properties:
        code:
          example: email_otp_expired
          type: string
        message:
          example: OTP has expired
          type: string
        param:
          nullable: true
          type: string
      type: object
    SubmitResponse:
      description: SubmitResponse schema
      example:
        id: 019f179b-0fa7-72c8-818e-819652540477
        status: under_review
        submitted_at: '2026-06-30T08:15:00Z'
      properties:
        id:
          example: 0195c1f0-1234-7000-8000-0123456789ab
          type: string
        status:
          example: under_review
          type: string
        submitted_at:
          format: date-time
          nullable: true
          type: string
      type: object
  securitySchemes:
    ApiKey:
      description: API token passed in the request header.
      in: header
      name: ds-api-token
      type: apiKey

````