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

# Skip Enrollment Step

> Skip a stuck non-branch step, preserving attempts and recording skipped history.

Uses the pinned graph's first outgoing edge, or completes with step_skipped.
Paused and archived automations allow skipping. Continuing runs become active
and due now for the normal post-commit due poller.



## OpenAPI

````yaml /openapi/mio-openapi.json post /api/v1/teams/{team_id}/hubs/{hub_id}/automations/{automation_id}/enrollments/{enrollment_id}/skip-step
openapi: 3.1.0
info:
  description: >-
    Production API reference for Membership.io. Use the authored guides for
    workflows and the generated endpoint pages for exact parameters and schemas.
  title: Membership.io API
  version: 0.1.0
servers:
  - description: Production
    url: https://api.member.dev
security:
  - bearerAuth: []
paths:
  /api/v1/teams/{team_id}/hubs/{hub_id}/automations/{automation_id}/enrollments/{enrollment_id}/skip-step:
    post:
      tags:
        - automations
      summary: Skip Enrollment Step
      description: >-
        Skip a stuck non-branch step, preserving attempts and recording skipped
        history.


        Uses the pinned graph's first outgoing edge, or completes with
        step_skipped.

        Paused and archived automations allow skipping. Continuing runs become
        active

        and due now for the normal post-commit due poller.
      operationId: >-
        automations.post_automations_post_teams_by_team_id_hubs_by_hub_id_automations_by_automation_id_enrollments_by_enrollment_id_skip_step
      parameters:
        - in: path
          name: team_id
          required: true
          schema:
            title: Team Id
            type: string
        - in: path
          name: hub_id
          required: true
          schema:
            title: Hub Id
            type: string
        - in: path
          name: automation_id
          required: true
          schema:
            title: Automation Id
            type: string
        - in: path
          name: enrollment_id
          required: true
          schema:
            title: Enrollment Id
            type: string
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/AutomationEnrollmentResponse'
          description: Successful Response
        '401':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Not authenticated
        '403':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Forbidden
        '404':
          content:
            application/vnd.api+json:
              examples:
                automation_enrollment_not_found:
                  value:
                    errors:
                      - code: automation_enrollment_not_found
                        detail: Automation enrollment not found.
                        meta:
                          request_id: request-id
                        status: '404'
                        title: Not Found
                automation_not_found:
                  value:
                    errors:
                      - code: automation_not_found
                        detail: Automation not found.
                        meta:
                          request_id: request-id
                        status: '404'
                        title: Not Found
                hub_not_found:
                  value:
                    errors:
                      - code: hub_not_found
                        detail: Hub not found.
                        meta:
                          request_id: request-id
                        status: '404'
                        title: Not Found
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Scoped hub, automation or enrollment not found
        '409':
          content:
            application/vnd.api+json:
              examples:
                automation_contact_already_enrolled:
                  value:
                    errors:
                      - code: automation_contact_already_enrolled
                        detail: >-
                          Another live enrollment exists for this automation and
                          contact.
                        meta:
                          request_id: request-id
                        status: '409'
                        title: Conflict
                automation_depth_limit:
                  value:
                    errors:
                      - code: automation_depth_limit
                        detail: >-
                          This enrollment has reached the automation step
                          execution limit.
                        meta:
                          request_id: request-id
                        status: '409'
                        title: Conflict
                automation_step_ambiguous:
                  value:
                    errors:
                      - code: automation_step_ambiguous
                        detail: >-
                          A stuck branch step cannot be skipped without
                          selecting a branch.
                        meta:
                          request_id: request-id
                        status: '409'
                        title: Conflict
                enrollment_not_stuck:
                  value:
                    errors:
                      - code: enrollment_not_stuck
                        detail: Enrollment is not stuck.
                        meta:
                          request_id: request-id
                        status: '409'
                        title: Conflict
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Enrollment recovery conflict
        '415':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Unsupported media type
        '422':
          content:
            application/vnd.api+json:
              examples:
                automation_step_missing:
                  value:
                    errors:
                      - code: automation_step_missing
                        detail: >-
                          The pinned automation version or current or next step
                          is missing.
                        meta:
                          request_id: request-id
                        status: '422'
                        title: Unprocessable Entity
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Invalid input or missing pinned step
        '429':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Action rate limit exceeded (120/hour)
      security:
        - HTTPBearer: []
components:
  schemas:
    AutomationEnrollmentResponse:
      additionalProperties: false
      properties:
        data:
          $ref: '#/components/schemas/AutomationEnrollmentResource'
      required:
        - data
      title: AutomationEnrollmentResponse
      type: object
    JsonApiErrorResponse:
      description: Error JSON:API response.
      properties:
        errors:
          items:
            $ref: '#/components/schemas/JsonApiError'
          title: Errors
          type: array
        meta:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Meta
      required:
        - errors
      title: JsonApiErrorResponse
      type: object
    AutomationEnrollmentResource:
      additionalProperties: false
      properties:
        attributes:
          $ref: '#/components/schemas/AutomationEnrollmentAttributes'
        id:
          title: Id
          type: string
        type:
          const: automation_enrollments
          default: automation_enrollments
          title: Type
          type: string
      required:
        - id
        - attributes
      title: AutomationEnrollmentResource
      type: object
    JsonApiError:
      properties:
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
        meta:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Meta
        source:
          anyOf:
            - additionalProperties:
                type: string
              type: object
            - type: 'null'
          title: Source
        status:
          title: Status
          type: string
        title:
          title: Title
          type: string
      required:
        - status
        - title
      title: JsonApiError
      type: object
    AutomationEnrollmentAttributes:
      additionalProperties: false
      description: Read-only attributes for an ``automation_enrollments`` resource.
      properties:
        automation_id:
          title: Automation Id
          type: string
        automation_version_id:
          title: Automation Version Id
          type: string
        contact_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Contact Id
        created_at:
          format: date-time
          title: Created At
          type: string
        current_node_id:
          title: Current Node Id
          type: string
        entered_at:
          format: date-time
          title: Entered At
          type: string
        exit_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Exit Reason
        exited_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Exited At
        file_id:
          anyOf:
            - type: string
            - type: 'null'
          title: File Id
        hub_id:
          title: Hub Id
          type: string
        next_due_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Next Due At
        run_attributes:
          additionalProperties: true
          title: Run Attributes
          type: object
        status:
          title: Status
          type: string
        status_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Status Reason
        step_execution_count:
          title: Step Execution Count
          type: integer
        subject_type:
          default: contact
          title: Subject Type
          type: string
        team_contact_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Team Contact Id
        team_id:
          title: Team Id
          type: string
        trigger_context:
          additionalProperties: true
          title: Trigger Context
          type: object
        updated_at:
          format: date-time
          title: Updated At
          type: string
      required:
        - automation_id
        - automation_version_id
        - team_id
        - hub_id
        - current_node_id
        - status
        - step_execution_count
        - entered_at
        - created_at
        - updated_at
      title: AutomationEnrollmentAttributes
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT or mio_sk API key
      description: >-
        Send platform JWTs, contact JWTs, or team API keys as `Authorization:
        Bearer <token>`.
      scheme: bearer
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````

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