---
title: "幂等保存一个接入步骤，不执行管线"
method: POST
path: "/onboarding/sessions/{id}/steps/{step}/apply"
tags: ["onboarding"]
---

# 幂等保存一个接入步骤，不执行管线

`POST /onboarding/sessions/{id}/steps/{step}/apply`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/onboarding/sessions/{id}/steps/{step}/apply`
- Auth: none declared

## Path parameters

- `id` string, required
- `step` 'preflight' | 'identity' | 'pipelines' | 'parameters' | 'template_flow' | 'review', required

## Request body

- InternalInterfacesHttpOnboardingApplyRequest
  - `expected_version` integer
  - `request_key` string

## Response `200`

OK

- InternalInterfacesHttpOnboardingSessionResponse
  - `data` GosInternalDomainOnboardingSession
    - `check` GosInternalDomainOnboardingCheck
      - `issues` GosInternalDomainOnboardingIssue[]
        - `code` string
        - `field_path` string
        - `message` string
        - `remedy` string
        - `severity` string
        - `step` string
      - `status` string
    - `created_at` string
    - `current_step` string
    - `draft` GosInternalDomainOnboardingDraft
      - `approval_flow_id` string
      - `branch` string
      - `cd_pipeline_id` string
      - `change_approval_flow` boolean: Existing application policies are preserved unless this explicit switch is set.
      - `ci_pipeline_id` string
      - `identity` GosInternalDomainOnboardingIdentity
        - `description` string
        - `key` string
        - `name` string
        - `owner_user_id` string
        - `project_id` string
        - `project_key` string
        - `project_name` string
      - `params` GosInternalDomainOnboardingParameter[]
        - `fixed_value` string
        - `name` string
        - `new_field_name` string
        - `omit` boolean
        - `param_key` string
        - `scope` string
        - `source_param_key` string
        - `value_source` string
      - `repo_url` string
      - `save_app_sources` boolean
      - `template_name` string
    - `first_release_order_id` string
    - `id` string
    - `mode` string
    - `owner_user_id` string
    - `refs` GosInternalDomainOnboardingReferences
      - `application_id` string
      - `cd_binding_id` string
      - `ci_binding_id` string
      - `project_id` string
      - `template_id` string
    - `status` string
    - `updated_at` string
    - `version` integer

## Other responses

- `403`: Forbidden
- `409`: Conflict
- `422`: Unprocessable Entity

## Changes

- **2026-09-09** `26b0f6ed4a12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/opsre/apis/gos-release-api/changes/onboarding/sessions/:id/steps/:step/apply/post.md)

---

[API](https://skmtc.dev/opsre/apis/gos-release-api.md) - [All operations](https://skmtc.dev/opsre/apis/gos-release-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opsre/apis/gos-release-api/revisions/26b0f6ed4a12?raw)