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

# Invite User (legacy)

> Invite one person to your organization, or resend their invitation, without workspaces.

> [!WARNING]
>
> **Legacy endpoint.** `/api/v1/invitations/` predates workspaces. It keeps working for existing integrations, but it cannot place an invitee in a workspace. New integrations should use [Invite User](https://docs.nekt.com/platform-api/invitations/organization/invite.md), which takes the same request with the role named `organization_role` and accepts `workspaces`.

The request takes `email`, `role` (`owner`, `admin`, or `member`; defaults to `member`), and the optional `first_name`, `last_name`, `functional_area`, and `other_functional_area`. It answers `201` for a new invitation and `200` for a resend, with the [legacy invitation object](https://docs.nekt.com/platform-api/invitations/legacy/invitation.md). The rules, resend behavior, and errors are the same as [Invite User](https://docs.nekt.com/platform-api/invitations/organization/invite.md).


## OpenAPI

````yaml POST /api/v1/invitations/
openapi: 3.0.3
info:
  title: Nekt API
  version: v1
  description: Nekt API Documentation
  contact:
    email: support@nekt.ai
servers:
  - url: https://api.nekt.ai
security: []
paths:
  /api/v1/invitations/:
    post:
      tags:
        - v1
      description: >-
        Invite one person, or resend the invitation they already have.


        `create` rather than `perform_create` because the status code depends on
        which of the two

        happened, and `perform_create` cannot influence it -- `CreateModelMixin`
        discards what it

        returns and answers 201 either way. A resend creates nothing, so it
        answers 200.
      operationId: v1_invitations_create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Invitation'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Invitation'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Invitation'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Invitation'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Invitation:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        first_name:
          type: string
          maxLength: 150
        last_name:
          type: string
          maxLength: 150
        email:
          type: string
          format: email
          title: Email address
          maxLength: 254
        role:
          allOf:
            - $ref: '#/components/schemas/OrganizationRoleEnum'
          default: member
          description: >-
            Defaults to `member`. You cannot invite somebody to a role above
            your own, and on the Free plan only owners can be invited.


            * `owner` - Owner

            * `admin` - Admin

            * `member` - Member
        functional_area:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/FunctionalAreaEnum'
            - $ref: '#/components/schemas/BlankEnum'
            - $ref: '#/components/schemas/NullEnum'
        other_functional_area:
          type: string
          nullable: true
          maxLength: 128
        sent_at:
          type: string
          format: date-time
          readOnly: true
        expires_at:
          type: string
          format: date-time
          readOnly: true
        accepted_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        revoked_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        created_by:
          allOf:
            - $ref: '#/components/schemas/OrganizationUser'
          readOnly: true
      required:
        - accepted_at
        - created_at
        - created_by
        - email
        - expires_at
        - id
        - revoked_at
        - sent_at
    OrganizationRoleEnum:
      enum:
        - owner
        - admin
        - member
      type: string
      description: |-
        * `owner` - Owner
        * `admin` - Admin
        * `member` - Member
    FunctionalAreaEnum:
      enum:
        - data_analytics
        - sales
        - customer_support
        - operations
        - marketing
        - finance
        - product_development
        - growth
        - executive_leadership
        - other
      type: string
      description: |-
        * `data_analytics` - Data & Analytics
        * `sales` - Sales
        * `customer_support` - Customer Support
        * `operations` - Operations
        * `marketing` - Marketing
        * `finance` - Finance
        * `product_development` - Product Development
        * `growth` - Growth
        * `executive_leadership` - Executive Leadership
        * `other` - Other
    BlankEnum:
      enum:
        - ''
    NullEnum:
      enum:
        - null
    OrganizationUser:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        first_name:
          type: string
          readOnly: true
        last_name:
          type: string
          readOnly: true
        email:
          type: string
          format: email
          readOnly: true
          title: Email address
        picture:
          type: string
          format: uri
          readOnly: true
          nullable: true
        role:
          type: string
          readOnly: true
        functional_area:
          readOnly: true
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/FunctionalAreaEnum'
            - $ref: '#/components/schemas/NullEnum'
        other_functional_area:
          type: string
          readOnly: true
          nullable: true
        date_joined:
          type: string
          format: date-time
          readOnly: true
        last_login:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        is_active:
          type: boolean
          readOnly: true
          default: false
        is_pending:
          type: boolean
          readOnly: true
          default: false
        joined_at:
          type: string
          format: date-time
          readOnly: true
          description: When the user joined the organization; null while they are pending.
        workspace_is_active:
          type: boolean
          nullable: true
          readOnly: true
          description: >-
            Whether the person can act in the requester's workspace: active in
            the organization AND in that workspace (spec rule 15); false when
            they are not a member of it. Populated on the organization's user
            list; null where this serializer is nested.
      required:
        - date_joined
        - email
        - first_name
        - functional_area
        - id
        - is_active
        - is_pending
        - joined_at
        - last_login
        - last_name
        - other_functional_area
        - picture
        - role
        - workspace_is_active
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API Key authentication. Format: ''x-api-key: api_key'''

````

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