User signup

POST /auth/signup

Registers a new user account.

application/json

Body Required

  • username string Required

    Maximum length is 50.

  • password string Required

    Maximum length is 100.

  • email string(email) Required

    Maximum length is 100.

  • first_name string Required

    Maximum length is 50.

  • last_name string Required

    Maximum length is 50.

Responses

  • 201

    User created successfully

  • 409 application/json

    Username already taken

    Hide response attributes Show response attributes object
    • error string Required

      Error type or category

    • message string Required

      Human-readable error message

    • timestamp string(date-time) Required

      Timestamp when the error occurred

    • success boolean

      Indicates if the operation was successful

    • details object

      Additional error details

      Additional properties are allowed.

  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • error string Required

      Error type or category

    • message string Required

      Human-readable error message

    • timestamp string(date-time) Required

      Timestamp when the error occurred

    • success boolean

      Indicates if the operation was successful

    • details object

      Additional error details

      Additional properties are allowed.

POST /auth/signup
curl \
 --request POST 'http://api.example.com/auth/signup' \
 --header "Content-Type: application/json" \
 --data '{"username":"string","password":"string","email":"hello@example.com","first_name":"string","last_name":"string"}'
Request examples
{
  "username": "string",
  "password": "string",
  "email": "hello@example.com",
  "first_name": "string",
  "last_name": "string"
}
Response examples (409)
{
  "error": "Bad Request",
  "message": "Invalid request parameter: name is required",
  "timestamp": "2024-01-15T10:30:00Z",
  "success": false,
  "details": {
    "validation_errors": {
      "name": "Organization name is required",
      "email": "Invalid email format"
    }
  }
}
Response examples (500)
{
  "error": "Bad Request",
  "message": "Invalid request parameter: name is required",
  "timestamp": "2024-01-15T10:30:00Z",
  "success": false,
  "details": {
    "validation_errors": {
      "name": "Organization name is required",
      "email": "Invalid email format"
    }
  }
}