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

# List Projects

> Returns project summaries. The example response below is illustrative only.



## OpenAPI

````yaml GET /projects
openapi: 3.1.0
info:
  title: Candidate Profile API
  version: 1.0.0
  description: >-
    Personal candidate profile API published at api.jonahanderson.me. Every
    endpoint except POST /auth/token requires bearer-token authentication. All
    example payloads in this spec are illustrative and do not represent live
    data.
servers:
  - url: https://api.jonahanderson.me
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Authentication
  - name: Candidate
  - name: Experience
  - name: Projects
  - name: Resume
  - name: Contact
paths:
  /projects:
    get:
      tags:
        - Projects
      summary: List projects
      description: >-
        Returns project summaries. The example response below is illustrative
        only.
      operationId: listProjects
      responses:
        '200':
          description: Project list.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ProjectSummary'
              examples:
                illustrativeResponse:
                  summary: Illustrative response
                  description: Sample values only. Live project data will vary.
                  value:
                    - id: project_example_001
                      name: Project Atlas
                      summary: >-
                        Example summary for a customer-facing workflow
                        automation product.
                    - id: project_example_002
                      name: Signal Console
                      summary: >-
                        Example summary for an internal dashboard used to
                        monitor integration health.
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    ProjectSummary:
      type: object
      description: Summary view of a project returned by the list endpoint.
      required:
        - id
        - name
        - summary
      properties:
        id:
          type: string
          description: Stable identifier for the project.
          example: project_example_001
        name:
          type: string
          description: Project name shown in the portfolio.
          example: Project Atlas
        summary:
          type: string
          description: Short summary of what the project is or does.
          example: Example summary for a customer-facing workflow automation product.
      example:
        id: project_example_001
        name: Project Atlas
        summary: Example summary for a customer-facing workflow automation product.
    ErrorResponse:
      type: object
      description: Wrapper object for API errors.
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/Error'
      example:
        error:
          code: BAD_REQUEST
          message: The request payload is missing a required field.
    Error:
      type: object
      description: Standard error payload returned by the API.
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Machine-readable error code.
          example: BAD_REQUEST
        message:
          type: string
          description: Human-readable explanation of the error.
          example: The request payload is missing a required field.
      example:
        code: BAD_REQUEST
        message: The request payload is missing a required field.
  responses:
    Unauthorized:
      description: Bearer token is missing, invalid, or altered.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            missingOrInvalidToken:
              summary: Valid bearer token required
              value:
                error:
                  code: UNAUTHORIZED
                  message: A valid bearer token is required
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Signed bearer token returned by POST /auth/token. Send it in the
        Authorization header as `Bearer <token>`.

````