Create Assistant

POST /api/v1/assistant

Creates a new AI assistant instance. Assistants can be specialized for either child or parent interactions.

Request Body:

{
  "company_name": "string",
  "name": "string",
  "description": "string",
  "is_child_assistant": "boolean"  // Indicates if the assistant is designed for child interactions
}

Response:

{
  "id": "string",
  "name": "string",
  "description": "string",
  "owner": "string",
  "timestamp": "string",
  "is_child_assistant": "boolean"
}

Create Conversation

POST /api/v1/conversation

Creates a new conversation between a human and an AI assistant. Enforces child safety by ensuring child users only interact with child-appropriate assistants.

Request Body:

{
  "api_key": "string",
  "human_id": "string",     // Prefix 'ch-' for child, 'pa-' for parent
  "assistant_id": "string", // Must match human type (child/parent)
  "title": "string",
  "summary": "string"
}

Response:

{
  "id": "string",
  "human_id": "string",
  "assistant_id": "string",
  "title": "string",
  "summary": "string",
  "timestamp": "string"
}

Error Responses:

400 Bad Request:
{
  "detail": "When creating a conversation for a child, the assistant must be designed for children"
}
{
  "detail": "When creating a conversation for a parent, the assistant must not be designed for children"
}

Create Parent

POST /api/v1/parent

Creates a new parent user.

Request Body:

{
  "email": "string",
  "company_name": "string",
  "name": "string",
  "surname": "string",
  "location": "string",
  "age": "integer",
  "gender": "enum"
}

Create Child

POST /api/v1/child

Creates a new child profile.

Request Body:

{
  "company_name": "string",
  "parent_id": "uuid",
  "name": "string",
  "surname": "string",
  "location": "string",
  "birthdate": "date",
  "gender": "enum"
}