# Sign up with pending invitation

**POST /auth/signup**

Creates a password user in local/dev only, requiring an invitation code before applying the code-matched pending invitation.


## Servers
- https://agentengine.mongodb.com: https://agentengine.mongodb.com ()


## Authentication methods
- Bearer auth


## Parameters



### Body: application/json (object)
Signup request
- **email** (string)

- **invitation_code** (string)

- **name** (string)

- **pwd** (string)



## Responses
### 201
Created

#### Body: application/json (object)
- **created_at** (string)

- **email** (string)
  User email, resolved for display only.

- **name** (string)
  User-provided display name; empty when the record has none.

- **org_ids** (array[string])

- **organizations** (array[object])
  Org memberships with display names; parallels OrgIDs.

- **role_assignments** (array[object])
  Scoped role assignments only

- **updated_at** (string)

- **user_id** (string)
  Stable user _id (hex) — the canonical user identifier.


### 400
Bad Request

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 403
Forbidden

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 409
Conflict

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 500
Internal Server Error

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)



[Powered by Bump.sh](https://bump.sh)