For AI agents: the complete documentation index for the Test API API is available at https://docs.eggubator.co/llms.txt. This page is also available as Markdown at https://docs.eggubator.co/endpoints/createuser.md (or send an Accept: text/markdown request header).

Create a user

POST https://google.com/users

OpenAPI definition for a single operation of the Test API API - parameters, request body, and response schemas.

openapi: 3.0.3
info:
  title: Test API
  description: >
    A fake in-memory pet store API used as a fixture for SDK integration testing. Provides CRUD
    operations for pets, users, orders, categories, and tags.
  version: 1.0.0
servers:
  - url: https://google.com
    description: API server
security:
  - bearerAuth: []
tags:
  - name: Pets
    description: Operations for managing pets
  - name: Users
    description: Operations for managing users
  - name: Orders
    description: Operations for managing orders
  - name: Categories
    description: Operations for managing pet categories
  - name: Tags
    description: Operations for managing tags
  - name: Internal
    description: Internal/admin endpoints
paths:
  /users:
    post:
      tags:
        - Users
      summary: Create a user
      description: Registers a new user. The user is automatically assigned an ID.
      operationId: createUser
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserInput'
      responses:
        '201':
          description: The newly created user
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >
        API key passed as a Bearer token in the Authorization header. Example: `Authorization:
        Bearer ps_live_abc123def456`
  parameters:
    ResourceId:
      name: id
      in: path
      required: true
      description: Numeric ID of the resource
      schema:
        type: integer
        example: 1
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: 'Invalid API key. Pass a valid key via Authorization: Bearer <key>'
  schemas:
    Pet:
      type: object
      properties:
        id:
          type: integer
          description: Auto-generated pet ID
          example: 1
        name:
          type: string
          description: Name of the pet
          example: Buddy
        species:
          type: string
          description: Species of the pet
          example: Dog
        age:
          type: integer
          description: Age of the pet in years
          example: 3
        status:
          type: string
          description: Availability status of the pet
          example: available
    PetInput:
      type: object
      properties:
        name:
          type: string
          description: Name of the pet
          example: Buddy
        species:
          type: string
          description: Species of the pet
          example: Dog
        age:
          type: integer
          description: Age of the pet in years
          example: 3
    User:
      type: object
      properties:
        id:
          type: integer
          description: Auto-generated user ID
          example: 1
        username:
          type: string
          description: Username
          example: jdoe
        email:
          type: string
          format: email
          description: Email address
          example: jdoe@example.com
        role:
          type: string
          description: User role
          example: admin
    UserInput:
      type: object
      properties:
        username:
          type: string
          description: Username
          example: jdoe
        email:
          type: string
          format: email
          description: Email address
          example: jdoe@example.com
        role:
          type: string
          description: User role
          example: admin
    Order:
      type: object
      properties:
        id:
          type: integer
          description: Auto-generated order ID
          example: 1
        userId:
          type: integer
          description: ID of the user who placed the order
          example: 1
        petId:
          type: integer
          description: ID of the pet being ordered
          example: 2
        status:
          type: string
          description: Current status of the order
          example: pending
        createdAt:
          type: string
          format: date-time
          description: ISO 8601 timestamp of when the order was created
          example: '2026-04-23T12:00:00.000Z'
    OrderInput:
      type: object
      properties:
        userId:
          type: integer
          description: ID of the user placing the order
          example: 1
        petId:
          type: integer
          description: ID of the pet being ordered
          example: 2
    Category:
      type: object
      properties:
        id:
          type: integer
          description: Auto-generated category ID
          example: 1
        name:
          type: string
          description: Category name
          example: Dogs
        description:
          type: string
          description: Category description
          example: All dog breeds
    CategoryInput:
      type: object
      properties:
        name:
          type: string
          description: Category name
          example: Dogs
        description:
          type: string
          description: Category description
          example: All dog breeds
    Tag:
      type: object
      properties:
        id:
          type: integer
          description: Auto-generated tag ID
          example: 1
        label:
          type: string
          description: Tag label
          example: friendly
    TagInput:
      type: object
      properties:
        label:
          type: string
          description: Tag label
          example: friendly
    HealthStatus:
      type: object
      properties:
        status:
          type: string
          description: Current server status
          example: ok
        uptime:
          type: number
          description: Server uptime in seconds
          example: 12345.67