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

# Attach a Domino object to a bundle

> Attach a Domino object to a bundle, as supporting evidence or as the governed entity itself. `type` and `identifier` together determine what's referenced; the required `identifier` shape depends on `type`:
| type | identifier shape |
|---|---|
| `ModelVersion` | `{"name": string, "version": number}` |
| `Report` (a file in the project's filesystem, not a generic report document) | `{"filename": string, "commit": string, "source": "DFS" / "GBP", "branch": string}` |
| `DatasetSnapshotFile` | `{"datasetId": string, "snapshotId": string, "filename": string}` |
| `Endpoint` | `{"endpointVersionId": string, "endpointId": string, "name": string, "version": number}` |
| `NetAppVolumeSnapshotFile` | `{"volumeId": string, "snapshotId": string, "filename": string}` |
| `FlowArtifactFile` | `{"artifactId": string, "filename": string, "executionName": string, "executionWorkflowName": string, "executionWorkflowVersion": string}` |
`id` is the bundle ID, from `POST /bundles` or `GET /bundles`.
Returns 409 if the bundle is already completed or archived (read-only).
Related:
- GET /attachment-overviews (list existing attachments across bundles)
- POST /rpc/delete-attachment-and-results (remove an attachment along with drafts and results on them)
- POST /rpc/bulk-add-attachments (attach to multiple bundles in one call)



## OpenAPI

````yaml /api-specs/cloud/public-api.json post /api/governance/v1/bundles/{id}/attachments
openapi: 3.0.3
info:
  title: Domino Public API
  description: Reference for Domino's public REST API endpoints.
  version: 6.4.0
  x-catalog-key: nucleus
servers:
  - url: https://mycluster.domino.tech
    description: >-
      Replace 'mycluster.domino.tech' with your Domino cluster hostname. For
      Domino Cloud customers, that is `your-subdomain`.domino.tech (e.g.,
      acme.domino.tech). For self-hosted deployments, it is the hostname you
      reach the Domino UI at.
security: []
tags:
  - name: Projects
  - name: Project templates
  - name: Workspaces
  - name: Jobs
  - name: HPC Jobs
  - name: Environments
  - name: Hardware Tiers
  - name: Datasets
  - name: Data Sources
  - name: GenAI
  - name: AI Systems
  - name: Apps
  - name: App versions
  - name: App instances
  - name: Model APIs
  - name: Registered models
  - name: Model deployment
  - name: Extensions
  - name: Cost and billing
  - name: Users and organizations
  - name: Service accounts
  - name: Personal Access Tokens
  - name: Personal Access Tokens (admin)
  - name: Audit Trail
  - name: Custom metrics
  - name: PPM
  - name: Model Monitoring models
  - name: Model Monitoring drift and quality
  - name: Model Monitoring settings
  - name: Model Monitoring authentication
  - name: Governance bundles
  - name: Governance policies
  - name: Governance evidence and results
  - name: Governance operations
  - name: NetApp Volumes
  - name: NetApp Volumes snapshots
  - name: NetApp Volumes filesystems
  - name: NetApp Volumes transfers
  - name: Tags
  - name: Properties
externalDocs:
  description: OpenAPI
  url: https://swagger.io/resources/open-api/
paths:
  /api/governance/v1/bundles/{id}/attachments:
    post:
      tags:
        - Governance bundles
      summary: Attach a Domino object to a bundle
      description: >-
        Attach a Domino object to a bundle, as supporting evidence or as the
        governed entity itself. `type` and `identifier` together determine
        what's referenced; the required `identifier` shape depends on `type`:

        | type | identifier shape |

        |---|---|

        | `ModelVersion` | `{"name": string, "version": number}` |

        | `Report` (a file in the project's filesystem, not a generic report
        document) | `{"filename": string, "commit": string, "source": "DFS" /
        "GBP", "branch": string}` |

        | `DatasetSnapshotFile` | `{"datasetId": string, "snapshotId": string,
        "filename": string}` |

        | `Endpoint` | `{"endpointVersionId": string, "endpointId": string,
        "name": string, "version": number}` |

        | `NetAppVolumeSnapshotFile` | `{"volumeId": string, "snapshotId":
        string, "filename": string}` |

        | `FlowArtifactFile` | `{"artifactId": string, "filename": string,
        "executionName": string, "executionWorkflowName": string,
        "executionWorkflowVersion": string}` |

        `id` is the bundle ID, from `POST /bundles` or `GET /bundles`.

        Returns 409 if the bundle is already completed or archived (read-only).

        Related:

        - GET /attachment-overviews (list existing attachments across bundles)

        - POST /rpc/delete-attachment-and-results (remove an attachment along
        with drafts and results on them)

        - POST /rpc/bulk-add-attachments (attach to multiple bundles in one
        call)
      parameters:
        - description: ID of the bundle to which the attachment belongs
          name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/rai-guardrails-service_guardrails.CreateAttachment
        description: Attachment to create
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/rai-guardrails-service_guardrails.Attachment
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rai-guardrails-service_server.HTTPError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rai-guardrails-service_server.HTTPError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rai-guardrails-service_server.HTTPError'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rai-guardrails-service_server.HTTPError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rai-guardrails-service_server.HTTPError'
components:
  schemas:
    rai-guardrails-service_guardrails.CreateAttachment:
      type: object
      required:
        - identifier
        - type
      properties:
        identifier:
          type: object
        source:
          $ref: >-
            #/components/schemas/rai-guardrails-service_guardrails.AttachmentSource
        type:
          $ref: >-
            #/components/schemas/rai-guardrails-service_guardrails.AttachmentType
    rai-guardrails-service_guardrails.Attachment:
      type: object
      properties:
        approvalTimelineMap:
          type: object
          additionalProperties:
            $ref: >-
              #/components/schemas/rai-guardrails-service_guardrails.ApprovalTimelineInfo
        createdAt:
          type: string
        createdBy:
          type: object
        id:
          type: string
        identifier:
          type: object
        source:
          $ref: >-
            #/components/schemas/rai-guardrails-service_guardrails.AttachmentSource
        type:
          $ref: >-
            #/components/schemas/rai-guardrails-service_guardrails.AttachmentType
    rai-guardrails-service_server.HTTPError:
      type: object
      properties:
        code:
          description: >-
            Code is a stable machine-readable error identifier; absent on most
            errors.
          allOf:
            - $ref: '#/components/schemas/rai-guardrails-service_guardrails.ErrorCode'
        message:
          type: string
    rai-guardrails-service_guardrails.AttachmentSource:
      type: string
      enum:
        - AUTO
        - MANUAL
      x-enum-varnames:
        - AttachmentSourceAuto
        - AttachmentSourceManual
    rai-guardrails-service_guardrails.AttachmentType:
      type: string
      enum:
        - ModelVersion
        - Report
        - DatasetSnapshotFile
        - Endpoint
        - NetAppVolumeSnapshotFile
        - FlowArtifact
        - FlowArtifactFile
      x-enum-varnames:
        - ModelVersion
        - Report
        - DatasetSnapshotFile
        - Endpoint
        - NetAppVolumeSnapshotFile
        - FlowArtifact
        - FlowArtifactFile
    rai-guardrails-service_guardrails.ApprovalTimelineInfo:
      type: object
      properties:
        approvalStatus:
          $ref: >-
            #/components/schemas/rai-guardrails-service_guardrails.ApprovalStatus
        timelineStatus:
          $ref: >-
            #/components/schemas/rai-guardrails-service_guardrails.ApprovalTimelineStatus
        updatedAt:
          type: string
    rai-guardrails-service_guardrails.ErrorCode:
      type: string
      enum:
        - BUNDLE_REQUIRES_POLICY
      x-enum-varnames:
        - CodeBundleRequiresPolicy
    rai-guardrails-service_guardrails.ApprovalStatus:
      type: string
      enum:
        - PendingSubmission
        - PendingReview
        - Approved
        - ConditionallyApproved
        - PendingExpiration
        - Expired
      x-enum-varnames:
        - PendingSubmission
        - PendingReview
        - Approved
        - ConditionallyApproved
        - PendingExpiration
        - Expired
    rai-guardrails-service_guardrails.ApprovalTimelineStatus:
      type: string
      enum:
        - Valid
        - Invalid
      x-enum-varnames:
        - Valid
        - Invalid

````

## Related topics

- [Attach each App's mandatory policies to its governed bundle](/api-reference/governance-operations/attach-each-apps-mandatory-policies-to-its-governed-bundle.md)
- [Bulk add attachments to bundles](/api-reference/governance-bundles/bulk-add-attachments-to-bundles.md)
- [Attachments](/cloud/platform-capabilities/features/governance/work-with-bundles/attachments.md)
- [List attachment overviews](/api-reference/governance-bundles/list-attachment-overviews.md)
