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

# Publish a Computer Agent Canvas

> Prepares dependencies declared by the selected Computer Agent's Canvas project when they changed or are unavailable, builds the editable source from the app workspace directory, and replaces the generated files served from public. Read the source first, make the intended workspace changes, publish, and then open the Canvas URL to verify the result.




## OpenAPI

````yaml post /api/v2/computer/accounts/{targetAccountId}/canvas/publish
openapi: 3.0.0
info:
  version: 2.0.0
  title: Vida API
  description: Vida API Documentation
servers:
  - url: https://api.vida.dev
    description: Vida Production
    variables:
      baseUrl:
        default: api.vida.dev
        description: Production API Root
security: []
tags:
  - name: Agents
  - name: Inbound Email
    description: Control which senders may create inbound email work for an Agent.
  - name: Features
    description: Inspect capabilities available within an account hierarchy.
  - name: Conversation Logs
    description: Query conversation activity and calculate account-level metrics.
  - name: Computer Agents
    description: Set up, configure, inspect, and manage Vida Computer Agents.
  - name: Computer Agent Sessions
    description: View and reset Computer Agent sessions.
  - name: Accounts
  - name: Agent Templates
    description: Create, manage, and apply reusable Agent configurations.
paths:
  /api/v2/computer/accounts/{targetAccountId}/canvas/publish:
    post:
      tags:
        - Computer Agents
      summary: Publish a Computer Agent Canvas
      description: >
        Prepares dependencies declared by the selected Computer Agent's Canvas
        project when they changed or are unavailable, builds the editable source
        from the app workspace directory, and replaces the generated files
        served from public. Read the source first, make the intended workspace
        changes, publish, and then open the Canvas URL to verify the result.
      operationId: canvasPostPublish
      parameters:
        - name: targetAccountId
          in: path
          required: true
          description: ''
          schema:
            type: string
      responses:
        '200':
          description: Canvas published
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  agentId:
                    oneOf:
                      - type: integer
                      - type: string
                  published:
                    type: boolean
                    enum:
                      - true
                  publishedAt:
                    type: string
                    format: date-time
                  phase:
                    type: string
                    enum:
                      - complete
                  dependencies:
                    type: object
                    required:
                      - status
                      - changed
                    properties:
                      status:
                        type: string
                        enum:
                          - ready
                          - updated
                      changed:
                        type: boolean
                required:
                  - agentId
                  - published
                  - publishedAt
                  - phase
                  - dependencies
        '502':
          description: >
            Canvas dependency preparation or source build failed. The error
            payload identifies the failed phase and includes bounded,
            project-relative output for diagnosing the project.
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: Vida API Token

````