atypica.AI

atypica.AI Docs

Developer Documentation

Authentication

Note: API access requires a team account. Personal accounts do not support API access.

All API requests require an API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Generate your API key from the team management dashboard.

Base URL

https://atypica.ai/api

List Members

GET/team/members

List all team members.

Request

curl -X GET https://atypica.ai/api/team/members \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (200 OK)

{
  "success": true,
  "data": [
    {
      "id": 42,
      "name": "John Doe",
      "email": "john@example.com",
      "createdAt": "2024-01-01T00:00:00.000Z",
      "personalUserId": 123
    }
  ]
}

Create User

POST/team/members/create

Create a new user and add them to the team. The email domain must be verified in your team's domain whitelist.

Note: Users created via API do not receive signup token bonuses.

Request Body

{
  "email": "user@verified-domain.com",
  "password": "optional_password"
}

Request

curl -X POST https://atypica.ai/api/team/members/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@verified-domain.com"}'

Response (200 OK)

{
  "success": true,
  "data": {
    "id": 789,
    "email": "user@verified-domain.com",
    "name": "user",
    "personalUserId": 456,
    "teamUserId": 789,
    "createdAt": "2024-01-01T00:00:00.000Z"
  }
}

Invite User

POST/team/members/invite

Invite an existing user to join the team. The user must already have a registered account, and their email domain must be verified in your team's domain whitelist.

Request Body

{
  "email": "existinguser@verified-domain.com"
}

Request

curl -X POST https://atypica.ai/api/team/members/invite \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "existinguser@verified-domain.com"}'

Response (200 OK)

{
  "success": true,
  "data": {
    "id": 790,
    "personalUserId": 456,
    "teamIdAsMember": 1,
    "name": "User Name",
    "createdAt": "2024-01-01T00:00:00.000Z"
  }
}

Impersonation

POST/team/members/:userId/impersonation

Generate impersonation login URL for a member.

Path Parameters

userIdnumberTeam member user ID

Request Body (optional)

{
  "expiryHours": 24
}

Request

curl -X POST https://atypica.ai/api/team/members/42/impersonation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expiryHours": 24}'

Response (200 OK)

{
  "success": true,
  "data": {
    "loginUrl": "https://atypica.ai/auth/impersonation-login?token=...",
    "expiryHours": 24,
    "expiresAt": "2024-01-02T00:00:00.000Z"
  }
}

Error Responses

401 Unauthorized

{
  "success": false,
  "error": "Unauthorized: API Key is required"
}

404 Not Found

{
  "success": false,
  "error": "Member not found in this team"
}

500 Internal Server Error

{
  "success": false,
  "error": "Internal server error"
}

Rate Limits

API requests are currently not rate-limited, but please use responsibly.

Rate limiting may be enforced in the future. We recommend implementing exponential backoff in your client.

API Documentation | atypica.AI