> ## Documentation Index
> Fetch the complete documentation index at: https://faces.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create API Key

> Create a new API key scoped to a team.



## OpenAPI

````yaml POST /auth/create-key
openapi: 3.1.0
info:
  title: Faces API
  version: '1.0'
  description: >-
    Faces API for creating and managing presentations. Generate presentations
    from prompts, or read and write individual slides. Each slide is a React
    component (face.tsx) with content blocks (face.content.json) and editor
    controls (face.controls.json).
servers:
  - url: https://faces.app/api/v1
    description: API v1
security:
  - bearerAuth: []
paths:
  /auth/create-key:
    post:
      tags:
        - Auth
      summary: Create an API key
      description: >-
        Create a new API key scoped to a team. The key inherits the team's
        access — projects created with it are owned by that team. The raw key is
        returned once, so store it securely. Omit both teamId and team to use
        your personal team.
      operationId: createApiKey
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 100
                  default: Default
                  description: A label for the key.
                team:
                  type: string
                  description: >-
                    Team id or slug to scope the key to. The authenticated user
                    must be a member. Defaults to your personal team.
      responses:
        '200':
          description: API key created
          content:
            application/json:
              schema:
                type: object
                properties:
                  key:
                    type: string
                    description: The raw API key. Shown once.
                  keyPrefix:
                    type: string
                    description: First 10 characters for identification.
                  name:
                    type: string
                required:
                  - key
                  - keyPrefix
                  - name
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key with "faces_" prefix. Create one at Settings > Developers.

````