> ## Documentation Index > Fetch the complete documentation index at: https://docs.lighton.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create a company > This endpoint allows authorized users to create a new company. Only SysAdmin and Account Manager roles can create companies. ## OpenAPI ````yaml /api-reference/openapi-v3.yaml post /api/v3/companies openapi: 3.0.3 info: title: Paradigm API version: xenial-xerus (v3) description: >- A versatile and adaptable tool designed to integrate Generative AI into your applications servers: - url: https://paradigm.lighton.ai security: [] tags: - name: Agents description: Operations about agents - name: Threads description: Operations about agents conversation threads - name: Tools description: Operations about native tools - name: Models description: Operations about AI models - name: MCP description: Operations about MCP servers - name: Sources description: Operations about sources used by agents conversation threads - name: Artifacts description: Operations about artifacts generated by agents conversation threads - name: Agent description: >- Operations about agents (deprecated). Please use the 'Agents' API component instead. - name: Files description: Operations about files - name: Files Processing description: Operations about files processing - name: Tags description: Operations about tags - name: Workspaces description: Operations about workspaces - name: Users description: Operations about users - name: User Groups description: Operations about user groups - name: Companies description: Operations about companies - name: SCIM description: Operations about SCIM paths: /api/v3/companies: post: tags: - Companies summary: Create a company description: |- This endpoint allows authorized users to create a new company. Only SysAdmin and Account Manager roles can create companies. operationId: api_v3_companies_create requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateCompanyRequest' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/CreateCompanyRequest' multipart/form-data: schema: $ref: '#/components/schemas/CreateCompanyRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/CompanyCreateResponse' description: Company created successfully '400': description: Invalid input (empty name, invalid fields) '403': description: Insufficient permissions '409': description: Company name already exists security: - bearerAuth: [] components: schemas: CreateCompanyRequest: type: object properties: name: type: string description: Company name dpo_email: type: string format: email nullable: true description: DPO contact email max_users: type: integer nullable: true description: Maximum allowed active users for this company allow_company_admins_to_manage_sso: type: boolean default: false description: Whether company admins can manage SSO configuration auto_provision_external_users: type: boolean default: false description: >- Automatically create user accounts when users log in via external auth (SSO/LDAP) for the first time. storage_limit_company_ws: type: integer nullable: true description: Company workspace storage limit in MB storage_limit_personal_ws: type: integer nullable: true description: Personal workspace storage limit in MB storage_limit_custom_ws: type: integer nullable: true description: Custom workspace storage limit in MB required: - name CompanyCreateResponse: type: object description: Serializer for company creation response properties: id: type: integer readOnly: true name: type: string description: The name of the company registered in the instance. maxLength: 255 dpo_email: type: string format: email nullable: true description: Contact email displayed in user profiles for data privacy inquiries. maxLength: 254 max_users: type: integer maximum: 2147483647 minimum: -2147483648 description: Maximum allowed active users for this company license. allow_company_admins_to_manage_sso: type: boolean description: >- If the company admins of this company can create & manage their SSO configuration. auto_provision_external_users: type: boolean description: >- Automatically create user accounts when users log in via external auth (SSO/LDAP) for the first time. storage_limit_company_ws: type: integer maximum: 2147483647 minimum: -2147483648 nullable: true description: >- Company workspace storage limit in MB. Leave blank to use the default value. Use 0 to disable uploads. storage_limit_personal_ws: type: integer maximum: 2147483647 minimum: -2147483648 nullable: true description: >- Limit for all combined personal workspaces in this company, in MB. Leave blank to use the default value. Use 0 to disable uploads. storage_limit_custom_ws: type: integer maximum: 2147483647 minimum: -2147483648 nullable: true description: >- Limit for all combined custom workspaces in this company, in MB. Leave blank to use the default value. Use 0 to disable uploads. created_at: type: string format: date-time readOnly: true login_method: allOf: - $ref: '#/components/schemas/LoginMethodEnum' description: |- Authentication method(s) allowed for users in this company. * `password` - Password * `sso` - Single Sign On * `ldap` - LDAP required: - allow_company_admins_to_manage_sso - created_at - id - name LoginMethodEnum: enum: - password - sso - ldap type: string description: |- * `password` - Password * `sso` - Single Sign On * `ldap` - LDAP securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer authentication header of the form `Bearer `, where `` is your auth token. ````