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

# Manage

> Read and update your saved agents, revisions, prepared releases, and tests. Production deployment is not connected.

Manage your private agents, revisions, prepared releases, and tests. See [Manage](https://darwin.so/docs/studio/manage.md) for commands, scopes, and availability.

Release preparation and deployment are separate. Production deployment, rollback execution, and production usage analytics are not connected.


## OpenAPI

````yaml openapi-publish.json POST /v3/manage
openapi: 3.1.0
info:
  title: Publish
  version: 3.0.0
  description: >-
    Owner-authorized agent and operation publishing, operating decisions and
    analytics, and durable campaign management. Publishing records does not
    bypass independent execution verification. Campaign submission requests
    review; it does not activate delivery or authorize spending.
servers:
  - url: https://api.darwin.so/api
security: []
paths:
  /v3/manage:
    post:
      tags:
        - Manage
      summary: Manage
      description: >-
        Read and update your saved agents, revisions, prepared releases, and
        tests. Production deployment is not connected.
      operationId: manage
      parameters:
        - name: Idempotency-Key
          in: header
          required: true
          description: >-
            Stable key for this exact mutation. Reusing it with different input
            returns 409.
          schema:
            type: string
            minLength: 1
            maxLength: 200
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - type: object
                  properties:
                    action:
                      type: string
                      const: list_agents
                    offset:
                      default: 0
                      type: integer
                      minimum: 0
                      maximum: 10000
                  required:
                    - action
                  additionalProperties: false
                - type: object
                  properties:
                    action:
                      type: string
                      const: get_agent
                    draftId:
                      type: string
                      minLength: 1
                      maxLength: 120
                  required:
                    - action
                    - draftId
                  additionalProperties: false
                - type: object
                  properties:
                    action:
                      type: string
                      const: create_update
                    draftId:
                      type: string
                      minLength: 1
                      maxLength: 120
                    revision:
                      type: integer
                      exclusiveMinimum: 0
                      maximum: 9007199254740991
                    expectedRevision:
                      type: integer
                      exclusiveMinimum: 0
                      maximum: 9007199254740991
                  required:
                    - action
                    - draftId
                    - revision
                    - expectedRevision
                  additionalProperties: false
                - type: object
                  properties:
                    action:
                      type: string
                      const: deployment_status
                    draftId:
                      type: string
                      minLength: 1
                      maxLength: 120
                    releaseId:
                      type: string
                      minLength: 1
                      maxLength: 120
                  required:
                    - action
                    - draftId
                    - releaseId
                  additionalProperties: false
                - type: object
                  properties:
                    action:
                      type: string
                      const: rollback
                    draftId:
                      type: string
                      minLength: 1
                      maxLength: 120
                    releaseId:
                      type: string
                      minLength: 1
                      maxLength: 120
                  required:
                    - action
                    - draftId
                    - releaseId
                  additionalProperties: false
            example:
              action: list_agents
      responses:
        '200':
          description: >-
            Current owner-scoped result. A mutation retry returns its saved
            response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
                additionalProperties: {}
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type:
                      - string
                      - array
                  code:
                    type: string
        '401':
          description: Missing or invalid credentials.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type:
                      - string
                      - array
                  code:
                    type: string
        '403':
          description: Insufficient scope or user authority.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type:
                      - string
                      - array
                  code:
                    type: string
        '404':
          description: Resource is absent or not owned by this caller.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type:
                      - string
                      - array
                  code:
                    type: string
        '409':
          description: Revision, handle, idempotency, or decision conflict.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type:
                      - string
                      - array
                  code:
                    type: string
        '503':
          description: Canonical product storage or migration is unavailable.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type:
                      - string
                      - array
                  code:
                    type: string
      security:
        - apiKey: []
        - apiKeyBearer: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
    apiKeyBearer:
      type: http
      scheme: bearer
      description: A Darwin API key supplied as an Authorization Bearer token.

````

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