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

# List a worker's saved versions

> The worker's saved settings, newest first: each save that changed them adds one, from the app or the API, and the newest is live. Settings the API doesn't show (its tool selection, MCP servers and outreach settings) are left out of `settings`. A restore puts back its tool selection and outreach settings, not its MCP servers.



## OpenAPI

````yaml /api/statisfy-api.openapi.json get /v1/digital_workers/{worker_id}/versions
openapi: 3.1.0
info:
  description: >-
    The agent-first Statisfy API. Authenticate with an API key (`Authorization:
    Bearer stfy_live_…`), then call `GET /v1/meta/capabilities` to discover
    every operation and its schemas.
  title: Statisfy API
  version: 1.0.0
servers:
  - url: https://api.statisfy.com
    description: Production
security: []
paths:
  /v1/digital_workers/{worker_id}/versions:
    get:
      tags:
        - digital_workers
      summary: List a worker's saved versions
      description: >-
        The worker's saved settings, newest first: each save that changed them
        adds one, from the app or the API, and the newest is live. Settings the
        API doesn't show (its tool selection, MCP servers and outreach settings)
        are left out of `settings`. A restore puts back its tool selection and
        outreach settings, not its MCP servers.
      operationId: digital_workers_list_versions
      parameters:
        - description: The worker's id, from GET /v1/digital_workers
          in: path
          name: worker_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkerVersionsResponse'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    WorkerVersionsResponse:
      properties:
        data:
          description: 'Newest first, at most 30: older ones are dropped as new ones come'
          items:
            $ref: '#/components/schemas/WorkerVersion'
          title: Data
          type: array
      required:
        - data
      title: WorkerVersionsResponse
      type: object
    WorkerVersion:
      properties:
        author:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Who saved it: a teammate's email or user id, a Statisfy person's
            email, `apikey:<id>` for an API key. Null for the platform's own
            saves
          title: Author
        created_at:
          description: When it was saved, ISO 8601 UTC
          title: Created At
          type: string
        id:
          description: Its id, for preview, evaluation runs and restore
          title: Id
          type: string
        label:
          anyOf:
            - type: string
            - type: 'null'
          title: Label
        live:
          description: 'Whether these are the worker''s settings now: true for the newest'
          title: Live
          type: boolean
        settings:
          $ref: '#/components/schemas/VersionSettings'
        source:
          description: >-
            Where the save came from: ui (the app), api, system (the platform)
            or seed
          title: Source
          type: string
        unavailable_skills:
          description: >-
            Its skill keys your workspace can't use now: a restore leaves them
            out
          items:
            type: string
          title: Unavailable Skills
          type: array
      required:
        - id
        - created_at
        - author
        - source
        - label
        - live
        - settings
        - unavailable_skills
      title: WorkerVersion
      type: object
    VersionSettings:
      description: >-
        A saved version's settings, named as GET /v1/digital_workers/{worker_id}
        names them.
      properties:
        accounts:
          $ref: '#/components/schemas/Accounts'
        assignment:
          $ref: '#/components/schemas/Assignment'
        autonomy:
          $ref: '#/components/schemas/Autonomy'
        channels:
          $ref: '#/components/schemas/Channels'
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: 'Its job, in plain words: every conversation it has opens with this'
          title: Description
        knowledge_bases:
          description: >-
            The knowledge bases it searched, of those your workspace still
            shares
          items:
            $ref: '#/components/schemas/KnowledgeBaseRef'
          title: Knowledge Bases
          type: array
        name:
          title: Name
          type: string
        outreach_enabled:
          title: Outreach Enabled
          type: boolean
        persona:
          $ref: '#/components/schemas/Persona'
        skills:
          items:
            $ref: '#/components/schemas/WorkerSkill'
          title: Skills
          type: array
      required:
        - name
        - description
        - persona
        - channels
        - autonomy
        - accounts
        - assignment
        - knowledge_bases
        - skills
        - outreach_enabled
      title: VersionSettings
      type: object
    Accounts:
      properties:
        segment:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: >-
            The accounts it covers: an account segment, the JSON the app's
            account filter builder saves (`entity` 4, the account, and its
            `conditions`). Null covers none. GET
            /v1/digital_workers/{worker_id}/accounts lists what it selects
          title: Segment
      required:
        - segment
      title: Accounts
      type: object
    Assignment:
      properties:
        owner_field:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            An account field naming the account's owner, such as its CSM, from
            GET /v1/fields?object=account
          title: Owner Field
        people:
          description: Teammates' person ids
          items:
            type: string
          title: People
          type: array
        strategy:
          description: >-
            How it picks among `people`: smart (the one with the fewest open
            conversations), round_robin (in turn) or unassigned (left for anyone
            to take)
          enum:
            - smart
            - round_robin
            - unassigned
          title: Strategy
          type: string
        to:
          description: >-
            Who a conversation it hands to a person is assigned to:
            account_owner (the person in the account's `owner_field`) or people
            (one of `people`, picked by `strategy`)
          enum:
            - account_owner
            - people
          title: To
          type: string
        when_teammate_answers:
          description: >-
            Who owns a conversation once a teammate answers in it: keep_owner,
            take_if_unowned (the teammate, when nobody owns it) or take (the
            teammate)
          enum:
            - keep_owner
            - take_if_unowned
            - take
          title: When Teammate Answers
          type: string
      required:
        - to
        - owner_field
        - people
        - strategy
        - when_teammate_answers
      title: Assignment
      type: object
    Autonomy:
      properties:
        channels:
          additionalProperties:
            enum:
              - auto
              - review
            type: string
          description: Channels that don't follow `default`, and what they do instead
          propertyNames:
            enum:
              - portal
              - in_app_sdk
              - email
              - slack
              - teams
          title: Channels
          type: object
        default:
          description: >-
            auto sends on its own and holds a reply for a person when it judges
            one should look; review holds every reply for a person
          enum:
            - auto
            - review
          title: Default
          type: string
      required:
        - default
        - channels
      title: Autonomy
      type: object
    Channels:
      properties:
        email:
          $ref: '#/components/schemas/EmailChannel'
        in_app_sdk:
          $ref: '#/components/schemas/ChatChannel'
          description: The chat widget in your own product
        portal:
          $ref: '#/components/schemas/ChatChannel'
          description: Your customer portal's chat
        slack:
          $ref: '#/components/schemas/SlackChannel'
          description: Your shared Slack channels with customers
        teams:
          $ref: '#/components/schemas/TeamsChannel'
          description: Your Microsoft Teams chats with customers
      required:
        - portal
        - in_app_sdk
        - email
        - slack
        - teams
      title: Channels
      type: object
    KnowledgeBaseRef:
      properties:
        id:
          description: >-
            The knowledge base's id, from GET /v1/knowledge_bases. A worker
            saved in the app may also hold one an Agent Studio agent keeps for
            its own files, which that list leaves out; it can keep it, but not
            add it again once removed
          title: Id
          type: string
        name:
          title: Name
          type: string
      required:
        - id
        - name
      title: KnowledgeBaseRef
      type: object
    Persona:
      properties:
        ai_disclosure:
          anyOf:
            - enum:
                - transparent
                - branded
                - hybrid
              type: string
            - type: 'null'
          description: >-
            How it says it is an AI: transparent (the first time it writes to
            someone), branded (it uses its name, and says so only when asked) or
            hybrid (when it matters, such as before promising a follow-up)
          title: Ai Disclosure
        greeting:
          anyOf:
            - type: string
            - type: 'null'
          description: Its first message in the portal and the in-app chat
          title: Greeting
        guardrails:
          anyOf:
            - type: string
            - type: 'null'
          description: Rules it always follows, ahead of everything else it is told
          title: Guardrails
        voice:
          anyOf:
            - type: string
            - type: 'null'
          description: 'How it writes: its tone, and how it addresses people'
          title: Voice
      required:
        - voice
        - greeting
        - ai_disclosure
        - guardrails
      title: Persona
      type: object
    WorkerSkill:
      properties:
        enabled:
          description: >-
            Whether it is on in your workspace (`enabled` on GET /v1/skills):
            the worker skips one that is off, archived or gone
          title: Enabled
          type: boolean
        key:
          description: The skill's key, from GET /v1/skills
          title: Key
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Null when the key names no skill your workspace has: the worker
            skips it
          title: Name
      required:
        - key
        - name
        - enabled
      title: WorkerSkill
      type: object
    EmailChannel:
      properties:
        acknowledge:
          description: Whether it acknowledges an email whose reply waits for a person
          title: Acknowledge
          type: boolean
        acknowledgement:
          anyOf:
            - type: string
            - type: 'null'
          description: What it tells the customer when a reply waits for a person
          title: Acknowledgement
        addresses:
          description: >-
            The mailboxes it reads and sends from: each a Google Workspace or
            Microsoft 365 mailbox connected to Statisfy with read and send,
            which no other active worker claims
          items:
            type: string
          title: Addresses
          type: array
        company_address:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The company mailbox that forwards to it. Its replies are sent as it,
            and copy it
          title: Company Address
        enabled:
          title: Enabled
          type: boolean
        forwarding:
          description: Whether it answers the mail your company mailbox forwards to it
          title: Forwarding
          type: boolean
        shared_mailboxes:
          description: >-
            Microsoft 365 shared mailboxes it reads through a teammate's
            delegated access
          items:
            type: string
          title: Shared Mailboxes
          type: array
        take_in_unknown_senders:
          description: >-
            Whether mail to it from a sender it can't place (no account, or an
            account no worker covers) shows on the board for a person to answer;
            it never answers that mail itself. Unset, it is on for a support
            worker and off for any other
          title: Take In Unknown Senders
          type: boolean
        watch_mailboxes:
          description: Whether it reads the mail that reaches `addresses`
          title: Watch Mailboxes
          type: boolean
      required:
        - enabled
        - addresses
        - shared_mailboxes
        - watch_mailboxes
        - forwarding
        - company_address
        - take_in_unknown_senders
        - acknowledge
        - acknowledgement
      title: EmailChannel
      type: object
    ChatChannel:
      properties:
        acknowledgement:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            What it tells the customer when a reply waits for a person; an
            enabled channel always sends it
          title: Acknowledgement
        enabled:
          title: Enabled
          type: boolean
      required:
        - enabled
        - acknowledgement
      title: ChatChannel
      type: object
    SlackChannel:
      properties:
        acknowledge:
          description: Whether it acknowledges a message whose reply waits for a person
          title: Acknowledge
          type: boolean
        acknowledgement:
          anyOf:
            - type: string
            - type: 'null'
          description: What it tells the customer when a reply waits for a person
          title: Acknowledgement
        enabled:
          title: Enabled
          type: boolean
        grouping:
          description: >-
            How its Slack messages become conversations: one per thread, or
            related messages grouped by topic
          enum:
            - thread
            - topic
          title: Grouping
          type: string
      required:
        - enabled
        - grouping
        - acknowledge
        - acknowledgement
      title: SlackChannel
      type: object
    TeamsChannel:
      properties:
        acknowledge:
          description: Whether it acknowledges a message whose reply waits for a person
          title: Acknowledge
          type: boolean
        acknowledgement:
          anyOf:
            - type: string
            - type: 'null'
          description: What it tells the customer when a reply waits for a person
          title: Acknowledgement
        enabled:
          title: Enabled
          type: boolean
      required:
        - enabled
        - acknowledge
        - acknowledgement
      title: TeamsChannel
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
      description: >-
        An API key, sent as `Authorization: Bearer stfy_live_…`. See
        [Authentication](/rest-api/authentication) for how to get one and which
        scopes it needs.

````

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