> ## 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.

# Retry Enrollment

> Grant exactly one extra attempt at the stuck run's pinned current step.

The run becomes active and due now. Scheduling uses the normal due poller
after the request commits. Requires an active automation and a stuck run.



## OpenAPI

````yaml /openapi/mio-openapi.json post /api/v1/teams/{team_id}/hubs/{hub_id}/automations/{automation_id}/enrollments/{enrollment_id}/retry
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}/retry:
    post:
      tags:
        - automations
      summary: Retry Enrollment
      description: >-
        Grant exactly one extra attempt at the stuck run's pinned current step.


        The run becomes active and due now. Scheduling uses the normal due
        poller

        after the request commits. Requires an active automation and a stuck
        run.
      operationId: >-
        automations.post_automations_post_teams_by_team_id_hubs_by_hub_id_automations_by_automation_id_enrollments_by_enrollment_id_retry
      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_not_active:
                  value:
                    errors:
                      - code: automation_not_active
                        detail: Automation must be active to retry an enrollment.
                        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
                recipient_suppressed:
                  value:
                    errors:
                      - code: recipient_suppressed
                        detail: >-
                          The enrollment contact is unavailable or the step
                          recipient is suppressed.
                        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.