# Update Project

POST /api/v2/projects/{projectId}

Updates a project's settings. Only the fields present in `changes` are written, so this is a partial update despite the POST. Slugs are unique across Saasco. Reusing one that belongs to another project returns 409.

## Request

- projectId: string, path, required — ID of the project to update.
- changes: object, required — Fields to change. Anything omitted is left as-is.
  - autoTopUpAmount: number — USD to charge when an auto top-up triggers. Minimum $20. Null clears it.
  - autoTopUpEnabled: boolean — Whether automatic credit top-up is enabled.
  - autoTopUpThreshold: number — Balance in USD that triggers an auto top-up. Minimum $10. Null clears it.
  - meta: object — Project metadata bag.
    - agentSetupStartedAt: string
    - companyAddressLine1: string
    - companyAddressLine2: string
    - companyCity: string
    - companyCountry: string
    - companyPostalCode: string
    - companyRegion: string
    - contactListVisibleColumns: object[]
    - defaultEmailCampaignSendOrder: object
    - defaultEmailFromDomain: string
    - defaultEmailFromName: string
    - defaultEmailFromUsername: string
    - knowledgeArticlesVisibleColumns: object[]
    - onboardingCompletedAt: string
    - onboardingManual: boolean
    - onboardingStep: name | apps | prompt | progress
    - sdkInstalledAt: string
    - setupGuideGoLiveConfirmed: boolean
    - setupGuideSkips: string[]
    - setupGuideTestEmailSent: boolean
    - setupGuideVisits: string[]
    - timezone: string
  - name: string — Display name of the project.
  - slug: string — Unique URL slug across Saasco. Reusing one that belongs to another project returns 409. A new slug cannot start with test_.
  - stripeCustomerId: string — Live Stripe customer ID.
  - tagline: string — Short description shown on the project.
  - testStripeCustomerId: string — T
…

## Response

- 200: Successful response
  - appConfigs: object[], required
    - activated: boolean, required
    - appId: string, required
    - createdAt: string, required
    - id: string, required
    - projectId: string, required
    - setupCompleted: boolean, required
    - updatedAt: string, required
  - autoTopUpEnabled: boolean, required
  - balance: number, required
  - balanceVersion: integer, required
  - createdAt: string, required
  - id: string, required
  - name: string, required
  - slug: string, required
  - updatedAt: string, required
  - autoTopUpAmount: number
  - autoTopUpThreshold: number
  - helpCenterId: string
  - liveProjectId: string
  - meta: object
    - agentSetupStartedAt: string
    - companyAddressLine1: string
    - companyAddressLine2: string
    - companyCity: string
    - companyCountry: string
    - companyPostalCode: string
    - companyRegion: string
    - contactListVisibleColumns: object[]
    - defaultEmailCampaignSendOrder: object
    - defaultEmailFromDomain: string
    - defaultEmailFromName: string
    - defaultEmailFromUsername: string
    - knowledgeArticlesVisibleColumns: object[]
    - onboardingCompletedAt: string
    - onboardingManual: boolean
    - onboardingStep: name | apps | prompt | progress
    - sdkInstalledAt: string
    - setupGuideGoLiveConfirmed: boolean
    - setupGuideSkips: string[]
    - setupGuideTestEmailSent: boolean
    - setupGuideVisits: string[]
    - timezone: string
  - stripeCustomerId: string
  - tagline: string
  - testStripeCustomerId: string
  - thumbnail: string
- 400: Invalid input data
- 401: Authoriz
…
