Julep Agents API

openapi: 3.0.0
info:
  title: Julep Agents API
  termsOfService: https://julep.ai/terms
  contact:
    name: Julep AI
    url: https://julep.ai
    email: developers@julep.ai
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  description: Julep is a backend for creating stateful AI apps with background tasks and long-term memory easily.
  version: 1.0.0
servers:
- url: https://{serverEnv}.julep.ai/api
  description: The julep cloud service endpoint
  variables:
    serverEnv:
      default: api
      description: The environment to use
      enum:
      - api
      - dev
security:
- ApiKeyAuth: []
- ApiKeyAuth_: []
tags:
- name: Agents
paths:
  /agents:
    get:
      operationId: AgentsRoute_list
      description: List Agents (paginated)
      parameters:
      - $ref: '#/components/parameters/Common.PaginationOptions.limit'
      - $ref: '#/components/parameters/Common.PaginationOptions.offset'
      - $ref: '#/components/parameters/Common.PaginationOptions.sort_by'
      - $ref: '#/components/parameters/Common.PaginationOptions.direction'
      - $ref: '#/components/parameters/Common.PaginationOptions.metadata_filter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Agents.Agent'
                required:
                - items
      tags:
      - Agents
    post:
      operationId: AgentsRoute_create
      description: Create a new Agent
      parameters: []
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agents.Agent'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Agents.CreateAgentRequest'
      tags:
      - Agents
  /agents/models:
    get:
      operationId: AgentsRoute_listModels
      description: List all available models
      parameters: []
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agents.ListModelsResponse'
      tags:
      - Agents
  /agents/{id}:
    post:
      operationId: AgentsRoute_createOrUpdate
      description: Create or update an Agent
      parameters:
      - $ref: '#/components/parameters/Agents.CreateOrUpdateAgentRequest.id'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agents.Agent'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Agents.UpdateAgentRequest'
      tags:
      - Agents
    put:
      operationId: AgentsRoute_update
      description: Update an existing Agent by id (overwrites existing values; use PATCH for merging instead)
      parameters:
      - name: id
        in: path
        required: true
        description: ID of the resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agents.Agent'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Agents.UpdateAgentRequest'
      tags:
      - Agents
    patch:
      operationId: AgentsRoute_patch
      description: Update an existing Agent by id (merges with existing values)
      parameters:
      - name: id
        in: path
        required: true
        description: ID of the resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agents.Agent'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Agents.PatchAgentRequest'
      tags:
      - Agents
    delete:
      operationId: AgentsRoute_delete
      description: Delete Agent by id
      parameters:
      - name: id
        in: path
        required: true
        description: ID of the resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Common.ResourceDeletedResponse'
      tags:
      - Agents
    get:
      operationId: AgentsRoute_get
      description: Get an Agent by id
      parameters:
      - name: id
        in: path
        required: true
        description: ID of the resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agents.Agent'
      tags:
      - Agents
  /agents/{id}/docs:
    post:
      operationId: AgentDocsRoute_create
      description: Create a Doc for this Agent
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Docs.Doc'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Docs.CreateDocRequest'
      tags:
      - Agents
    get:
      operationId: AgentDocsRoute_list
      description: List Docs owned by an Agent
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - $ref: '#/components/parameters/Common.PaginationOptions.limit'
      - $ref: '#/components/parameters/Common.PaginationOptions.offset'
      - $ref: '#/components/parameters/Common.PaginationOptions.sort_by'
      - $ref: '#/components/parameters/Common.PaginationOptions.direction'
      - $ref: '#/components/parameters/Common.PaginationOptions.metadata_filter'
      - name: include_embeddings
        in: query
        required: false
        description: Whether to include embeddings in the response
        schema:
          type: boolean
          default: true
        explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Docs.Doc'
                required:
                - items
      tags:
      - Agents
    delete:
      operationId: AgentDocsRoute_deleteBulk
      description: Bulk delete Docs owned by an Agent
      parameters:
      - name: id
        in: path
        required: true
        description: ID of the parent
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Common.ResourceDeletedResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Docs.BulkDeleteDocsRequest'
      tags:
      - Agents
  /agents/{id}/docs/{child_id}:
    delete:
      operationId: AgentDocsRoute_delete
      description: Delete a Doc for this Agent
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - name: child_id
        in: path
        required: true
        description: ID of the resource to be deleted
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Common.ResourceDeletedResponse'
      tags:
      - Agents
  /agents/{id}/search:
    post:
      operationId: AgentsDocsSearchRoute_search
      description: Search Docs owned by an Agent
      parameters:
      - name: id
        in: path
        required: true
        description: ID of the parent
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Docs.DocSearchResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                body:
                  anyOf:
                  - $ref: '#/components/schemas/Docs.VectorDocSearchRequest'
                  - $ref: '#/components/schemas/Docs.TextOnlyDocSearchRequest'
                  - $ref: '#/components/schemas/Docs.HybridDocSearchRequest'
              required:
              - body
      tags:
      - Agents
  /agents/{id}/secrets:
    get:
      operationId: AgentSecretsRoute_list
      description: List secrets (paginated)
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - $ref: '#/components/parameters/Common.PaginationOptions.limit'
      - $ref: '#/components/parameters/Common.PaginationOptions.offset'
      - $ref: '#/components/parameters/Common.PaginationOptions.sort_by'
      - $ref: '#/components/parameters/Common.PaginationOptions.direction'
      - $ref: '#/components/parameters/Common.PaginationOptions.metadata_filter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Secrets.Secret'
                required:
                - items
      tags:
      - Agents
    post:
      operationId: AgentSecretsRoute_create
      description: Create a new secret
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Secrets.Secret'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Secrets.CreateSecretRequest'
      tags:
      - Agents
  /agents/{id}/secrets/{child_id}:
    put:
      operationId: AgentSecretsRoute_update
      description: Update an existing secret by id (overwrites existing values)
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - name: child_id
        in: path
        required: true
        description: ID of the resource to be updated
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Secrets.Secret'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Secrets.UpdateSecretRequest'
      tags:
      - Agents
    delete:
      operationId: AgentSecretsRoute_delete
      description: Delete a secret by id
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - name: child_id
        in: path
        required: true
        description: ID of the resource to be deleted
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Common.ResourceDeletedResponse'
      tags:
      - Agents
  /agents/{id}/tasks:
    get:
      operationId: TasksRoute_list
      description: List tasks (paginated)
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - $ref: '#/components/parameters/Common.PaginationOptions.limit'
      - $ref: '#/components/parameters/Common.PaginationOptions.offset'
      - $ref: '#/components/parameters/Common.PaginationOptions.sort_by'
      - $ref: '#/components/parameters/Common.PaginationOptions.direction'
      - $ref: '#/components/parameters/Common.PaginationOptions.metadata_filter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Tasks.Task'
                required:
                - items
      tags:
      - Agents
    post:
      operationId: TasksRoute_create
      description: Create a new task
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tasks.Task'
      requestBody:
        required: true
        content:
          application/yaml:
            schema:
              $ref: '#/components/schemas/Tasks.CreateTaskRequest'
          text/x-yaml:
            schema:
              $ref: '#/components/schemas/Tasks.CreateTaskRequest'
          text/yaml:
            schema:
              $ref: '#/components/schemas/Tasks.CreateTaskRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/Tasks.CreateTaskRequest'
      tags:
      - Agents
  /agents/{id}/tasks/{child_id}:
    put:
      operationId: TasksRoute_update
      description: Update an existing task (overwrite existing values)
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - name: child_id
        in: path
        required: true
        description: ID of the resource to be updated
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tasks.Task'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Tasks.UpdateTaskRequest'
      tags:
      - Agents
    patch:
      operationId: TasksRoute_patch
      description: Update an existing task (merges with existing values)
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - name: child_id
        in: path
        required: true
        description: ID of the resource to be patched
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tasks.Task'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Tasks.PatchTaskRequest'
      tags:
      - Agents
    delete:
      operationId: TasksRoute_delete
      description: Delete a task by its id
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - name: child_id
        in: path
        required: true
        description: ID of the resource to be deleted
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Common.ResourceDeletedResponse'
      tags:
      - Agents
  /agents/{id}/tools:
    get:
      operationId: AgentToolsRoute_list
      description: List tools of the given agent
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - $ref: '#/components/parameters/Common.PaginationOptions.limit'
      - $ref: '#/components/parameters/Common.PaginationOptions.offset'
      - $ref: '#/components/parameters/Common.PaginationOptions.sort_by'
      - $ref: '#/components/parameters/Common.PaginationOptions.direction'
      - $ref: '#/components/parameters/Common.PaginationOptions.metadata_filter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Tools.Tool'
                required:
                - items
      tags:
      - Agents
    post:
      operationId: AgentToolsRoute_create
      description: Create a new resource owned by the given parent
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          content:
            application/json:
              schema:
                type: string
                enum:
                - Create a new tool for this agent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Agents.CreateAgentRequest'
      tags:
      - Agents
  /agents/{id}/tools/{child_id}:
    put:
      operationId: AgentToolsRoute_update
      description: Update a resource owned by the given parent using its id
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - name: child_id
        in: path
        required: true
        description: ID of the resource to be updated
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: string
                enum:
                - Update an existing tool (overwrite existing values)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Tools.UpdateToolRequest'
      tags:
      - Agents
    patch:
      operationId: AgentToolsRoute_patch
      description: Patch a resource owned by the given parent using its id
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - name: child_id
        in: path
        required: true
        description: ID of the resource to be patched
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: string
                enum:
                - Update an existing tool (merges with existing values)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Tools.PatchToolRequest'
      tags:
      - Agents
    delete:
      operationId: AgentToolsRoute_delete
      description: Delete an existing tool by id
      parameters:
      - name: id
        in: path
        required: true
        description: ID of parent resource
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - name: child_id
        in: path
        required: true
        description: ID of the resource to be deleted
        schema:
          $ref: '#/components/schemas/Common.uuid'
      responses:
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Common.ResourceDeletedResponse'
      tags:
      - Agents
  /agents/{parent_id}/tasks/{id}:
    post:
      operationId: TasksCreateOrUpdateRoute_createOrUpdate
      description: Create or update a task
      parameters:
      - name: parent_id
        in: path
        required: true
        description: ID of the agent
        schema:
          $ref: '#/components/schemas/Common.uuid'
      - $ref: '#/components/parameters/Tasks.CreateOrUpdateTaskRequest.id'
      responses:
        '201':
          description: The request has succeeded and a new resource has been created as a result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tasks.Task'
      requestBody:
        required: true
        content:
          application/yaml:
            schema:
              $ref: '#/components/schemas/Tasks.CreateTaskRequest'
          text/x-yaml:
            schema:
              $ref: '#/components/schemas/Tasks.CreateTaskRequest'
          text/yaml:
            schema:
              $ref: '#/components/schemas/Tasks.CreateTaskRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/Tasks.CreateTaskRequest'
      tags:
      - Agents
components:
  schemas:
    Tools.UnstructuredIntegrationDefUpdate:
      type: object
      properties:
        provider:
          type: string
          enum:
          - unstructured
          description: The provider must be "unstructured"
          default: unstructured
        method:
          type: string
          description: The specific method of the integration to call
        setup:
          allOf:
          - $ref: '#/components/schemas/Tools.UnstructuredSetupUpdate'
          description: The setup parameters for Unstructured
        arguments:
          allOf:
          - $ref: '#/components/schemas/Tools.UnstructuredPartitionArgumentsUpdate'
          description: The arguments for Unstructured
      allOf:
      - $ref: '#/components/schemas/Tools.BaseIntegrationDefUpdate'
      description: Unstructured integration definition
    Tools.WeatherGetArgumentsUpdate:
      type: object
      properties:
        location:
          type: string
          description: The location for which to fetch weather data
      description: Arguments for Weather
    Tools.BraveIntegrationDef:
      type: object
      required:
      - provider
      properties:
        provider:
          type: string
          enum:
          - brave
          description: The provider must be "brave"
          default: brave
        method:
          type: string
          description: The specific method of the integration to call
        setup:
          allOf:
          - $ref: '#/components/schemas/Tools.BraveSearchSetup'
          description: The setup parameters for Brave
        arguments:
          allOf:
          - $ref: '#/components/schemas/Tools.BraveSearchArguments'
          description: The arguments for Brave Search
      allOf:
      - $ref: '#/components/schemas/Tools.BaseIntegrationDef'
      description: Brave integration definition
    Secrets.UpdateSecretRequest:
      type: object
      required:
      - name
      - value
      properties:
        metadata:
          type: object
          additionalProperties: {}
        name:
          type: string
          description: Name of the secret
        description:
          type: string
          description: Description of what the secret is used for
        value:
          type: string
          description: The decrypted secret value
    Common.uuid:
      type: string
      format: uuid
    Common.ResourceDeletedResponse:
      type: object
      required:
      - id
      - deleted_at
      - jobs
      properties:
        id:
          allOf:
          - $ref: '#/components/schemas/Common.uuid'
          description: ID of deleted resource
        deleted_at:
          type: string
          format: date-time
          description: When this resource was deleted as UTC date-time
          readOnly: true
        jobs:
          type: array
          items:
            $ref: '#/components/schemas/Common.uuid'
          description: IDs (if any) of jobs created as part of this request
          default: []
          readOnly: true
    Tools.LlamaParseFetchArgumentsUpdate:
      type: object
      properties:
        filename:
          type: string
          description: File Name. If not provided, a random name will be generated.
        file:
          anyOf:
          - type: string
          - type: array
            items:
              type: string
          description: The base64 string of the file, which can be a single string or a list of strings
        params:
          type: object
          additionalProperties: {}
          description: Optional upload parameters
        base64:
          type: boolean
          description: The input file is base64
          default: false
      description: Arguments for LlamaParse integration
    Tools.FunctionCallOption:
      type: object
      required:
      - name
      properties:
        name:
          type: string
          description: The name of the function
        arguments:
          type: string
          description: The parameters to pass to the function
    Tools.GoogleSheetsBatchReadArguments:
      type: object
      required:
      - spreadsheet_id
      - ranges
      properties:
        spreadsheet_id:
          type: string
          description: The ID of the spreadsheet to read from
        ranges:
          type: array
          items:
            type: string
          description: The A1 notation of the ranges to read
        major_dimension:
          type: string
          enum:
          - ROWS
          - COLUMNS
          description: The major dimension that results should use
          default: ROWS
        value_render_option:
          type: string
          enum:
          - FORMATTED_VALUE
          - UNFORMATTED_VALUE
          - FORMULA
          description: How values should be represented in the output
          default: FORMATTED_VALUE
        date_time_render_option:
          type: string
          enum:
          - SERIAL_NUMBER
          - FORMATTED_STRING
          description: How dates, times, and durations should be represented
          default: FORMATTED_STRING
      description: Arguments for batch reading values from multiple ranges
    Tools.WikipediaIntegrationDef:
      type: object
      required:
      - provider
      properties:
        provider:
          type: string
          enum:
          - wikipedia
          description: The provider must be "wikipedia"
          default: wikipedia
        method:
          type: string
          description: The specific method of the integration to call
        setup:
          nullable: true
          description: The setup parameters for Wikipedia
          default: null
        arguments:
          allOf:
          - $ref: '#/components/schemas/Tools.WikipediaSearchArguments'
          description: The arguments for Wikipedia Search
      allOf:
      - $ref: '#/components/schemas/Tools.BaseIntegrationDef'
      description: Wikipedia integration definition
    Tools.WikipediaSearchArguments:
      type: object
      required:
      - query
      - load_max_docs
      properties:
        query:
          type: string
          description: The search query string
        load_max_docs:
          type: integer
          format: uint8
          minimum: 1
          maximum: 10
          description: Maximum number of documents to load
          default: 2
      description: Arguments for Wikipedia Search
    Tasks.ReturnStep:
      type: object
      required:
      - kind_
      - return
      properties:
        kind_:
          type: string
          enum:
          - return
          default: return
          readOnly: true
        return:
          type: object
          additionalProperties:
            anyOf:
            - $ref: '#/components/schemas/Common.PyExpression'
            - type: array
              items:
                $ref: '#/components/schemas/Common.PyExpression'
            - type: object
              additionalProperties:
                $ref: '#/components/schemas/Common.PyExpression'
            - type: array
              items:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/Common.PyExpression'
          description: The value to return
      allOf:
      - type: object
        required:
        - kind_
        properties:
          kind_:
            type: string
            enum:
            - return
            description: The kind of step
            readOnly: true
          label:
            allOf:
            - $ref: '#/components/schemas/Common.stepLabel'
            description: The label of this step for referencing it from other steps
        discriminator:
          propertyName: kind_
          mapping: {}
    Common.stepLabel:
      type: string
      maxLength: 120
      pattern: ^[^0-9]|^[0-9]+[^0-9].*$
      description: A valid step label
    Tools.McpListToolsArgumentsUpdate:
      type: object
      properties:
        dummy:
          type: string
          

# --- truncated at 32 KB (250 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/julep/refs/heads/main/openapi/julep-agents-api-openapi.yml