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

# Invite Participant

> The server checks current session access and resource permissions on every request. Acceptance does not prove provider execution.

The administrator supplies an existing Darwin account email and `viewer` or `contributor`. Explain before inviting that existing messages and attached content will become visible. The recipient must accept; a session URL alone grants no access.


## OpenAPI

````yaml openapi-v3.json POST /v3/sessions/{sessionId}/invitations
openapi: 3.1.0
info:
  title: Navigator
  version: 3.0.0
servers:
  - url: https://api.darwin.so/api
security: []
paths:
  /v3/sessions/{sessionId}/invitations:
    post:
      tags:
        - Sessions
      summary: Invite Participant
      description: >-
        The server checks current session access and resource permissions on
        every request. Acceptance does not prove provider execution.
      operationId: invite_session_member
      parameters:
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
            pattern: ^asst_[a-f0-9-]{36}$
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SessionInvitation'
      responses:
        '200':
          description: Accepted state.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Invalid request.
        '401':
          description: Authentication required.
        '403':
          description: Current access or resource authority denied.
        '404':
          description: Not found.
        '409':
          description: Idempotency or revision conflict.
        '429':
          description: >-
            Request rate or guest session allowance exceeded. The error code
            distinguishes message, operation, agent and concurrency limits.
        '503':
          description: Service unavailable.
      security:
        - apiKey: []
        - bearer: []
components:
  schemas:
    SessionInvitation:
      type: object
      properties:
        email:
          type: string
          maxLength: 254
          format: email
          pattern: >-
            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
        role:
          type: string
          enum:
            - viewer
            - contributor
      required:
        - email
        - role
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
    bearer:
      type: http
      scheme: bearer

````

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