NimbusNexus V1:account:careers Applications API

openapi: 3.2.0
info:
  title: NimbusNexus API — External V1:account:careers Applications…
  description: 'External (public) API intended for client-facing integrations and the web portal.


    Authentication:

    - This API uses JWT Bearer authentication.

    - In Swagger UI, click ''Authorize'' and sign in via the configured token endpoint.

    - Swagger will automatically attach the header: Authorization: Bearer .'
  version: test
servers:
- url: /
  description: Current host
- url: https://fastapi.dev.nimbusnexus.net
  description: Development
security:
- SwaggerLogin: []
- ApiKeyAuth: []
tags:
- name: v1:account:careers-applications
paths:
  /api/v1/account/careers-applications:
    post:
      tags:
      - v1:account:careers-applications
      summary: Submit Careers Application
      description: 'Records a careers application. Multipart body with the resume PDF

        attached as `resume`. The resume is uploaded to a private Swift

        container; metadata is stored in `careers_applications`. Originating

        IP is captured for fraud forensics; auto-anonymised after 24 months

        by the retention job.'
      operationId: submit_careers_application_api_v1_account_careers_applications_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_submit_careers_application_api_v1_account_careers_applications_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CareersApplicationSuccessOut'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseBaseErrorOut'
              example:
                success: false
                message: Bad Request
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseValidationErrorOut'
              example:
                success: false
                errors:
                  field:
                  - Invalid value
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseBaseErrorOut'
              example:
                success: false
                message: Internal Server Error
      security:
      - SwaggerLogin: []
      - ApiKeyAuth: []
components:
  schemas:
    ResponseValidationErrorOut:
      properties:
        success:
          type: boolean
          title: Success
          default: false
        errors:
          additionalProperties:
            items:
              type: string
            type: array
          type: object
          title: Errors
      type: object
      required:
      - errors
      title: ResponseValidationErrorOut
    ResponseBaseErrorOut:
      properties:
        success:
          type: boolean
          title: Success
          default: false
        message:
          type: string
          title: Message
      type: object
      required:
      - message
      title: ResponseBaseErrorOut
    CareersApplicationSuccessOut:
      properties:
        success:
          type: boolean
          title: Success
          default: true
        application_id:
          type: string
          title: Application Id
          description: Server-assigned id of the new application
      type: object
      required:
      - application_id
      title: CareersApplicationSuccessOut
      description: 'Acknowledgement wrapper. The marketing site only needs to know

        the submission was accepted; the application id is included so a

        confirmation email (when wired) can deep-link to a status page.'
    Body_submit_careers_application_api_v1_account_careers_applications_post:
      properties:
        role_slug:
          type: string
          maxLength: 80
          title: Role Slug
        first_name:
          type: string
          maxLength: 80
          title: First Name
        last_name:
          type: string
          maxLength: 80
          title: Last Name
        email:
          type: string
          maxLength: 254
          title: Email
        location:
          type: string
          maxLength: 200
          title: Location
        why:
          type: string
          maxLength: 2000
          title: Why
        phone:
          anyOf:
          - type: string
            maxLength: 40
          - type: 'null'
          title: Phone
        linkedin:
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          title: Linkedin
        source:
          anyOf:
          - type: string
            maxLength: 20
          - type: 'null'
          title: Source
        resume:
          type: string
          format: binary
          title: Resume
      type: object
      required:
      - role_slug
      - first_name
      - last_name
      - email
      - location
      - why
      - resume
      title: Body_submit_careers_application_api_v1_account_careers_applications_post
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    SwaggerLogin:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/v1/account/login_swagger
          scopes: {}
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key format -  base64('<id>:<secret>')