> ## Documentation Index > Fetch the complete documentation index at: https://docs.neo.projectdiscovery.io/llms.txt > Use this file to discover all available pages before exploring further. # Invite member > Invite a new member to the team by email. The member can be an existing or new user. ## OpenAPI ````yaml https://neo.api.projectdiscovery.io/api/openapi.json post /api/v1/teams/members/invite openapi: 3.1.0 info: contact: name: ProjectDiscovery url: https://neo.projectdiscovery.io description: Neo API Server - Security agent orchestration platform license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 title: Neo API version: 1.0.0 servers: - description: Production url: https://neo.api.projectdiscovery.io - description: Local development url: http://localhost:8080 security: [] tags: - description: Task execution and management name: Tasks - description: Agent listing and management name: Agents - description: Public agent directory name: Agent Directory - description: User file storage management name: Files - description: User working memory management name: Memory - description: Scheduled and recurring task management name: Schedules - description: Knowledge base and semantic search name: Knowledge - description: Encrypted user credentials and API keys name: Secrets - description: Neo API key management for programmatic access name: API Keys - description: User profile and account information name: User - description: Task and LLM usage tracking name: Usage - description: Bring Your Own Key provider management name: BYOK - description: Model discovery and capabilities name: Models - description: Third-party integrations name: Integrations - description: Skill knowledge documents for agent prompts name: Skills - description: Team management and member invitations name: Teams - description: Prompt library management and discovery name: Prompts - description: Slack bot integration for workspace installation and OAuth name: Slack - description: GitHub integration for PR reviews and repository management name: GitHub - description: Vulnerability issue tracking and management name: Issues - description: Subscription billing and plans name: Billing - description: Project management and member assignments name: Projects - description: SSH key pair generation and management for remote server access name: SSH Keys - description: Codebase structural analysis and mapping name: Codemaps - description: AI-generated codebase documentation and security analysis name: CodeWiki - description: Captured HTTP traffic query and replay name: Network Events paths: /api/v1/teams/members/invite: post: tags: - Teams summary: Invite member description: >- Invite a new member to the team by email. The member can be an existing or new user. operationId: post-v1-teams-members-invite requestBody: content: application/json: schema: $ref: '#/components/schemas/InviteMemberRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/TeamMemberResponse' description: Invitation sent '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Team member limit reached or invalid request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden - only team owner or admin can invite '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Team not found '409': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Member already invited or exists security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: InviteMemberRequest: properties: billable: default: true description: >- Whether this member consumes a paid subscription seat. false invites a non-premium member (no seat, zero credit access) - bypasses the seat limit but the member cannot run paid tasks until promoted. type: boolean email: description: Email of the member to invite format: email type: string project_access: allOf: - $ref: '#/components/schemas/ProjectAccess' default: all description: >- Project access scope for the member. 'all' (default) grants access to every shared team project. 'restricted' grants access only to projects the member is explicitly added to. Ignored for admins (always 'all'). role: allOf: - $ref: '#/components/schemas/TeamMemberRole' default: member description: Role to assign to the member spending_cap_usd: description: >- Optional cap to apply at invite time, closing the gap until an admin can PATCH /cap. format: float minimum: 0 nullable: true type: number required: - email type: object TeamMemberResponse: properties: member: $ref: '#/components/schemas/TeamMember' required: - member type: object ErrorResponse: properties: code: description: > Stable machine-readable error code — branch on this rather than matching the human `error`/`message` strings. Domain codes include `user_spending_cap_reached`, `project_spending_cap_reached`, and `insufficient_neo_credits`; otherwise it mirrors the error kind (e.g. `forbidden`, `invalid_request`, `not_exists`, `already_exists`). example: user_spending_cap_reached type: string error: example: Bad request type: string error_id: description: Correlation id for a specific error instance, when present. type: string kind: description: Coarse error category (e.g. "forbidden request", "invalid request"). example: forbidden request type: string message: description: | Human-readable detail (the kind prefixed to the error). For display, not for branching. type: string required: - error type: object ProjectAccess: description: >- Project access scope for a team member. 'all' grants access to every shared team project, current and future. 'restricted' grants access only to projects the member is explicitly added to. Admins always have 'all' access. enum: - all - restricted type: string TeamMemberRole: description: >- Role of a team member (admin=full access, member=write access, viewer=read-only) enum: - admin - member - viewer type: string TeamMember: properties: accepted_at: description: When the invitation was accepted format: date-time nullable: true type: string billable: description: >- Whether this member consumes a paid subscription seat. false = non-premium (no seat, no credit access). type: boolean cap: allOf: - $ref: '#/components/schemas/SpendingCapStatus' description: >- Effective spending-cap status (source/limit/used/remaining). Null when the team isn't on a spend-controls plan. RBAC: admins see every member's cap; a non-admin sees their own and null for other members. nullable: true created_at: description: When the team member record was created format: date-time type: string email: description: Member email format: email type: string id: description: Member ID format: uuid type: string invited_at: description: When the invitation was sent format: date-time type: string invited_by: description: >- Email of the user who invited this member (null if inviter was deleted) format: email nullable: true type: string project_access: $ref: '#/components/schemas/ProjectAccess' role: $ref: '#/components/schemas/TeamMemberRole' status: $ref: '#/components/schemas/TeamMemberStatus' updated_at: description: When the team member record was last updated format: date-time type: string required: - id - email - role - status - invited_at type: object SpendingCapStatus: properties: limit: description: Effective cap in USD. null when source is "none". format: float nullable: true type: number remaining: description: limit − used, clamped ≥ 0. null when source is "none". format: float nullable: true type: number source: description: >- What the effective limit comes from — an explicit per-member override, the team-wide default, or none (bounded only by the team pool / not on a spend-controls plan). enum: - override - global_default - none type: string used: description: USD spent in the current cap window. format: float type: number required: - source type: object TeamMemberStatus: description: >- Status of a team member (pending=invited, accepted=accepted invite, auto_joined=joined via domain auto-join) enum: - pending - accepted - auto_joined type: string securitySchemes: BearerAuth: bearerFormat: JWT description: JWT authentication token scheme: bearer type: http ApiKeyAuth: description: Neo API key (neo_sk_* prefix) in: header name: X-Api-Key type: apiKey ````