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

# Create a new resume

> Creates a new resume with the given name, slug, and tags. Optionally initializes the resume with sample data by setting withSampleData to true. The slug must be unique across the user's resumes. Returns the ID of the newly created resume. Requires authentication.



## OpenAPI

````yaml /spec.json post /resumes
openapi: 3.1.1
info:
  title: Reactive Resume
  version: 5.1.0
  description: Reactive Resume API
  license:
    name: MIT
    url: https://github.com/amruthpillai/reactive-resume/blob/main/LICENSE
  contact:
    name: Amruth Pillai
    email: hello@amruthpillai.com
    url: https://amruthpillai.com
servers:
  - url: http://localhost:3000/api/openapi
security:
  - apiKey: []
externalDocs:
  url: https://docs.rxresu.me
  description: Reactive Resume Documentation
paths:
  /resumes:
    post:
      tags:
        - Resumes
      summary: Create a new resume
      description: >-
        Creates a new resume with the given name, slug, and tags. Optionally
        initializes the resume with sample data by setting withSampleData to
        true. The slug must be unique across the user's resumes. Returns the ID
        of the newly created resume. Requires authentication.
      operationId: createResume
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  description: The name of the resume.
                slug:
                  type: string
                  minLength: 1
                  description: The slug of the resume.
                tags:
                  type: array
                  items:
                    type: string
                  description: The tags of the resume.
                withSampleData:
                  type: boolean
                  default: false
              required:
                - name
                - slug
                - tags
      responses:
        '200':
          description: The ID of the newly created resume.
          content:
            application/json:
              schema:
                type: string
                description: The ID of the created resume.
        '400':
          description: '400'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: RESUME_SLUG_ALREADY_EXISTS
                      status:
                        const: 400
                      message:
                        type: string
                        default: A resume with this slug already exists.
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header
      description: The API key to authenticate requests.

````