---
title: "update"
method: PATCH
path: "/api/agents/{id}"
tags: ["Agent"]
---

# update

`PATCH /api/agents/{id}`

## Path parameters

- `id` string, required

## Request body

- object
  - `data` object, required
    - `type` string, required
    - `id` string, required
    - `attributes` object, required
      - `name` string, required
      - `projectId` string
      - `modelType` string, required
      - `maxToolIterations` integer
      - `temperature` number, float
      - `outputs` object[]
        - `name` string, required
        - `functionName` string, required
        - `jsonSchema` string, required
        - `functionDescription` string
        - `artifactType` 'IMAGE_ID_OUTPUT' | 'MARKDOWN_TEXT_OUTPUT' | 'REACT_OUTPUT' | 'PRESENTATION'
        - `artifactContentType` 'IMAGE_ID_OUTPUT' | 'MARKDOWN_TEXT_OUTPUT' | 'REACT_OUTPUT' | 'PRESENTATION'
      - `systemPrompt` string, nullable
      - `starterMessage` string, nullable
      - `reasoningEffort` 'NONE' | 'MINIMAL' | 'LOW' | 'MEDIUM' | 'HIGH'
      - `tools` object[]
        - `toolTargetId` string, required
        - `toolTargetType` string, required
        - `targetFunction` string, required
        - `functionName` string, required
        - `functionDescription` string
        - `agentOutputMode` 'RETURN' | 'SHOW', nullable
        - `agentPromptSchema` string
        - `agentPromptTemplate` string
        - `inheritChatFiles` boolean
      - `variables` object[]
        - `name` string, required
        - `toolTargetId` string, required
        - `toolTargetType` string, required
        - `targetFunction` string, required
        - `functionArgumentsText` string

## Response `200`

updates an agent if the modelType to a non-deprecated model_type

## Other responses

- `400` — Forbidden - insufficient permissions to modify this agent
- `401` — Rejected by 401
- `404` — Agent not found
- `422` — PATCH /api/agents rejects {"temperature":-2}

---

[API](https://skmtc.net/treasure/apis/llm-api.md) · [All operations](https://skmtc.net/treasure/apis/llm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasure/llm-api/revisions/56f275763358/schema)