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

# Launch Admin Handoff

> Start a sign-in to Admin from the hub owner's Contact session.

Needs the signed hub handoff proof that only the team owner's linked Contact
session carries, and the request must come from the hub's current address.
Writes a one-use launch; the Admin page registers its browser against it.



## OpenAPI

````yaml /openapi/mio-openapi.json post /api/v1/contact-auth/admin-handoff/launches
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/contact-auth/admin-handoff/launches:
    post:
      tags:
        - contact-auth
      summary: Launch Admin Handoff
      description: >-
        Start a sign-in to Admin from the hub owner's Contact session.


        Needs the signed hub handoff proof that only the team owner's linked
        Contact

        session carries, and the request must come from the hub's current
        address.

        Writes a one-use launch; the Admin page registers its browser against
        it.
      operationId: contact_auth.post_contact_auth_post_contact_auth_admin_handoff_launches
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/AdminHandoffLaunchEnvelope'
        required: true
      responses:
        '201':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/AdminHandoffLaunchResponse'
          description: Successful Response
        '422':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - HTTPBearer: []
components:
  schemas:
    AdminHandoffLaunchEnvelope:
      additionalProperties: false
      properties:
        data:
          $ref: '#/components/schemas/AdminHandoffLaunchRequestResource'
      required:
        - data
      title: AdminHandoffLaunchEnvelope
      type: object
    AdminHandoffLaunchResponse:
      additionalProperties: false
      properties:
        data:
          $ref: '#/components/schemas/AdminHandoffLaunchResource'
      required:
        - data
      title: AdminHandoffLaunchResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    AdminHandoffLaunchRequestResource:
      additionalProperties: false
      properties:
        attributes:
          $ref: '#/components/schemas/_AdminHandoffLaunchRequestAttributes'
        type:
          const: admin_handoff_launches
          title: Type
          type: string
      required:
        - type
        - attributes
      title: AdminHandoffLaunchRequestResource
      type: object
    AdminHandoffLaunchResource:
      additionalProperties: false
      properties:
        attributes:
          $ref: '#/components/schemas/AdminHandoffLaunchAttributes'
        id:
          title: Id
          type: string
        type:
          const: admin_handoff_launches
          default: admin_handoff_launches
          title: Type
          type: string
      required:
        - id
        - attributes
      title: AdminHandoffLaunchResource
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    _AdminHandoffLaunchRequestAttributes:
      additionalProperties: false
      properties:
        hub_id:
          maxLength: 36
          minLength: 1
          title: Hub Id
          type: string
      required:
        - hub_id
      title: _AdminHandoffLaunchRequestAttributes
      type: object
    AdminHandoffLaunchAttributes:
      additionalProperties: false
      properties:
        deadline:
          description: Every step of this handoff must finish before it.
          format: date-time
          title: Deadline
          type: string
        expires_at:
          format: date-time
          title: Expires At
          type: string
        launch_id:
          description: >-
            One-use launch id. Carry it only in URL fragments, never a query
            string.
          title: Launch Id
          type: string
        start_url:
          description: Open this in the tab that will go on to Admin.
          title: Start Url
          type: string
      required:
        - launch_id
        - start_url
        - expires_at
        - deadline
      title: AdminHandoffLaunchAttributes
      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.