openapi: 3.0.3
info:
  title: Carrier Schedule Internal Handoff API
  version: 1.0.0
  description: Internal-only handoff contract; it is not a platform or merchant frontend API.
paths:
  /internal/firstleg/v1/carrier-schedule-queries/{queryId}/stop:
    post:
      summary: Stop tracking after the overseas pickup handoff has completed
      parameters:
        - {name: queryId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
        - {name: X-Internal-Service-Token, in: header, required: true, schema: {type: string}}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [reason]
              properties:
                reason: {type: string, minLength: 1, maxLength: 500}
      responses:
        '200': {description: Idempotent STOPPED task detail}