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

# Attach a round's artefact

> Attach what this round is testing, as pasted text (name + text) or a
URL. It replaces any artefact the round already has. Attaching only stores
it: nothing is planned from it.



## OpenAPI

````yaml https://api.semilattice.ai/openapi.json post /v1/projects/{project_id}/rounds/{round_id}/artefact
openapi: 3.1.0
info:
  title: Semilattice API
  description: >-
    Plan and run simulations of how your users will react to your work, and read
    the results. Everything you create is saved in your Semilattice account, so
    it also appears in the app.


    Authenticate with an API key from **Settings → API Keys** in the app, sent
    as `Authorization: Bearer <key>`.
  contact:
    name: Semilattice API
    url: https://semilattice.ai/
    email: support@semilattice.ai
  version: v1.0.0
servers:
  - url: https://api.semilattice.ai
security:
  - BearerAuth: []
tags:
  - name: Simulations
    description: >-
      A simulation asks one or more user models questions (User Research) or
      sends their simulated users through a page or a flow (User Journey). It is
      planned first, then run once you have checked the plan.
  - name: Projects
    description: >-
      A project groups the simulations about one piece of work, split into
      rounds.
  - name: Rounds
    description: >-
      A round is one version of what you are testing: the document, page or file
      it tests, its simulations, and one synthesis across them.
  - name: Context
    description: >-
      Your context is the background on your company or product that every
      simulation is planned against.
  - name: User Models
    description: >-
      A user model is a simulated version of a specific group of people, built
      from real human data. Every simulation runs against one or more. A segment
      is a user model cut from another by its simulated users' attributes.
  - name: Simulation Schema
    description: >-
      The goals each kind of simulation offers, and what each goal needs from
      you.
paths:
  /v1/projects/{project_id}/rounds/{round_id}/artefact:
    post:
      tags:
        - Rounds
      summary: Attach a round's artefact
      description: >-
        Attach what this round is testing, as pasted text (name + text) or a

        URL. It replaces any artefact the round already has. Attaching only
        stores

        it: nothing is planned from it.
      operationId: >-
        attach_artefact_route_v1_projects__project_id__rounds__round_id__artefact_post
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Project Id
        - name: round_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Round Id
        - name: authorization
          in: header
          required: false
          schema:
            type: string
            title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AttachArtefactBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AttachArtefactBody:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
          description: A name for pasted text, e.g. 'Pricing page v2'
        text:
          anyOf:
            - type: string
            - type: 'null'
          title: Text
          description: The artefact as pasted text
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
          description: A page to read the artefact from
      type: object
      title: AttachArtefactBody
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

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