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

# List item docs



## OpenAPI

````yaml /api/work.openapi.json get /v1/items/{id}/docs
openapi: 3.1.1
info:
  title: Work API
  description: >-
    The governed Work OS API (AD-9) — the same /v1 surface the app and agents
    use. Errors are RFC 9457 application/problem+json. The audit +
    member-activity lists are cursor-paginated.
  version: 1.2.6
  x-source: worksong-ai/Boardy@ebb4f0964633f024012c12b6bcc5b77e855dbf23
servers:
  - url: https://boardy.worksong.ai
    description: Work API
security: []
tags:
  - name: Agents
  - name: Artifacts
  - name: Attachments
  - name: Audit
  - name: Authority
  - name: Automation catalog
  - name: Automations
  - name: Boards
  - name: Columns
  - name: Dashboards
  - name: Docs
  - name: Email
  - name: Folders
  - name: Forms
  - name: Gates
  - name: Hub ticket
  - name: Imports
  - name: Integrations
  - name: Invitations
  - name: Items
  - name: Knowledge graph
  - name: Limit status
  - name: Me
  - name: Members
  - name: Notifications
  - name: Oauth
  - name: Positions
  - name: Proposals
  - name: Public
  - name: Rag
  - name: Remote agents
  - name: Responsibilities
  - name: Search
  - name: Session
  - name: Settings
  - name: Signup
  - name: Templates
  - name: Tokens
  - name: Tools
  - name: Views
  - name: Widgets
  - name: Workspaces
paths:
  /v1/items/{id}/docs:
    get:
      tags:
        - Items
      summary: List item docs
      operationId: ListItemDocs
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Doc'
      security:
        - clerkSession: []
        - apiToken: []
components:
  schemas:
    Doc:
      required:
        - id
        - tenantId
        - title
        - content
        - embeds
      type: object
      properties:
        id:
          type: string
          format: uuid
        tenantId:
          type: string
          format: uuid
        title:
          type: string
        content:
          type: string
        embeds:
          type: array
          items:
            $ref: '#/components/schemas/DocEmbed'
        workspaceId:
          type:
            - 'null'
            - string
          format: uuid
        version:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
          default: 1
        ownerItemId:
          type:
            - 'null'
            - string
          format: uuid
    DocEmbed:
      required:
        - id
        - refType
        - refId
      type: object
      properties:
        id:
          type: string
          format: uuid
        refType:
          $ref: '#/components/schemas/DocRefType'
        refId:
          type: string
          format: uuid
    DocRefType:
      enum:
        - Board
        - Item
        - View
  securitySchemes:
    clerkSession:
      type: http
      description: >-
        Clerk session JWT (deployments with Clerk auth) — validated per request
        (issuer + signature + lifetime + authorized-party). The internal Boardy
        tenant/member are resolved from the token's ACTIVE Clerk organization
        (`org_id`) → the Boardy tenant it maps to → this user's member in that
        tenant (#356). A token with no active organization is rejected;
        production never trusts spoofable `X-Tenant-Id`/`X-Member-Id` headers.
        The same normalized context backs the SPA, this OpenAPI surface, and
        MCP.
      scheme: bearer
      bearerFormat: JWT
    apiToken:
      type: http
      description: >-
        Boardy API token (`bdy_…`) for external integrations — acts as its bound
        Member capped by the token's scope, authorized through the Action
        Boundary. The token already carries its internal tenant/member.
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.