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

# List Workspaces

> List all Organizations a given user is part of



## OpenAPI

````yaml GET /api/user/{user_id}/organization/list
openapi: 3.0.3
info:
  title: Petal API Document
  description: Reference document for Petal app
  license:
    name: MIT
  version: 1.2.5
servers:
  - url: https://cite.petal.org
security:
  - bearerAuth: []
tags:
  - name: signup
  - name: extraction
  - name: referral
  - name: site
  - name: citegen
  - name: invite
  - name: user
  - name: tag
  - name: ai
  - name: notification
  - name: organization
  - name: annotation
  - name: search
  - name: attachment
  - name: collection
  - name: discourse
  - name: main
  - name: ai-create
  - name: document
  - name: payment
  - name: comment
  - name: lambda
  - name: sauce
  - name: admin
  - name: error
  - name: opengraph
  - name: default
  - name: media
  - name: file
  - name: oauth
paths:
  /api/user/{user_id}/organization/list:
    get:
      tags:
        - user
        - organization
      summary: List all organizations of which the user is a member
      description: List all Organizations a given user is part of
      operationId: get_/api/user/{user_id}/organization/list
      parameters:
        - description: The unique ID of the user
          in: path
          name: user_id
          required: true
          schema:
            format: int32
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationList'
          description: OK
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
          description: Unprocessable Entity
components:
  schemas:
    OrganizationList:
      additionalProperties: false
      items:
        $ref: '#/components/schemas/Organization'
      title: OrganizationList
      type: array
    ValidationError:
      description: Model of a validation error response.
      items:
        $ref: '#/components/schemas/ValidationError.ValidationErrorElement'
      title: ValidationError
      type: array
    Organization:
      additionalProperties: false
      properties:
        created_at:
          title: Created At
          description: Creation time, by UTC
          type: string
        description:
          title: Description
          description: Admin-provided description of the Organization
          type: string
        id:
          title: ID
          description: Unique ID of Organization
          type: integer
        is_personal:
          title: Is Personal
          description: >-
            Whether this is a personal Organization (automatically created upon
            user account creation)
          type: boolean
        meta:
          title: Meta
          description: Metadata, for internal use
          type: object
        modified_at:
          title: Modified At
          description: Modification time, by UTC
          type: string
        modified_by:
          title: Modified By
          description: Last user to modify
          type: integer
        name:
          title: Name
          description: Name of Organization
          type: string
        schema:
          $ref: '#/components/schemas/OrganizationSchemaList'
        user_id:
          title: User ID
          description: ID of owner
          type: integer
      required:
        - id
        - description
        - is_personal
        - meta
        - schema
        - created_at
        - modified_at
        - modified_by
      title: Organization
      type: object
    ValidationError.ValidationErrorElement:
      description: Model of a validation error response element.
      properties:
        ctx:
          title: Error context
          type: object
        loc:
          items:
            type: string
          title: Missing field name
          type: array
        msg:
          title: Error message
          type: string
        type:
          title: Error type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationErrorElement
      type: object
    OrganizationSchemaList:
      additionalProperties: false
      items:
        $ref: '#/components/schemas/OrganizationSchema'
      title: OrganizationSchemaList
      type: array
    OrganizationSchema:
      additionalProperties: false
      properties:
        default:
          default: true
          title: Default
          type: boolean
        description:
          default: ''
          title: Description
          type: string
        label:
          default: ''
          title: Label
          type: string
        name:
          title: Name
          type: string
        type:
          title: Type
          type: string
      required:
        - name
        - type
      title: OrganizationSchema
      description: Organization metadata, for internal use
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````