Save Claude Managed Agent settings for an agent

Saves Claude Managed settings. Prefer providerApiKeyId from /agents/provider-api-keys when a saved Anthropic key exists. Put Leadtime-managed model, editor-field instructions, and custom MCP servers under config.managedAgent. Instructions are a standard Leadtime editor field: send HTML, Markdown, or ProseMirror IDoc JSON, and Leadtime converts it to internal IDoc before syncing HTML to Claude. Put GitHub repository defaults under config.githubRepositoryDefaults. Use config.toolMode=basic by default when the agent only needs task context, comments, and status updates while doing external work or analysis. Use config.toolMode=full only when the agent is meant to perform broad Leadtime workspace actions such as creating or editing projects, tasks, organizations, contacts, forms, planning data, settings, or other company-management records. Re-read this endpoint after saving to verify the selected model, tool mode, MCP servers, and repositories.

POST/agents/{id}/claude

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Query parameters

fieldsToReturnstring

Comma-separated list of top-level response fields to return. Overrides the endpoint compact default unless responseShape=full is used.

responseShapestring

Advanced override. Omit for the endpoint compact default. Use full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:compactfull

Header parameters

LT-Response-Shapestring

Advanced override. Set to full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:full

Request body

requiredapplication/json

anthropicApiKeystring | null

Raw Anthropic API key. Prefer providerApiKeyId when a saved key exists.

configobject

Claude Managed configuration. Put model changes under config.managedAgent.modelId and GitHub defaults under config.githubRepositoryDefaults.

Show properties

agentIdstring | null

Existing Anthropic agent id when agentSource is existing.

agentSourcestring

Use leadtimeManaged when Leadtime should create and repair the Claude agent, environment, and vault.

Allowed:leadtimeManagedexisting

allowNetworkAccessboolean

Allow unrestricted outbound network access from the Claude cloud sandbox. When disabled, Leadtime still allows its own app/API/MCP hosts.

customGuidancestring | null

Extra guidance appended to Leadtime task-session instructions.

environmentIdstring | null

Existing Anthropic environment id when agentSource is existing.

exposeRawApiCredentialToAgentboolean

Expose a raw Leadtime API credential to the agent for trusted automation.

githubRepositoryDefaultsClaudeManagedGithubRepositoryDto[]

Default GitHub repositories mounted into Claude coding sessions for this agent.

Show properties

Array of ClaudeManagedGithubRepositoryDto

cloneUrlstring | nullrequired

Repository clone URL.

fullNamestringrequired

Repository full name, for example owner/repo.

idnumberrequired

GitHub repository id.

namestringrequired

Repository short name.

privatebooleanrequired

Whether the GitHub repository is private.

urlstringrequired

GitHub web URL.

managedAgentobject

Leadtime-managed Claude agent configuration. Put modelId, instructions, and mcpServers here.

Show properties

instructionsstring | object

Standard Leadtime editor field for managed Claude agent instructions. Accepts Markdown, HTML, or ProseMirror IDoc JSON (object or JSON string); Leadtime converts it to internal IDoc before storing and syncing the rendered HTML to Claude.

Use only the nodes and marks documented below for this field.

In HTML you can use:

Node Types and Marks

Nodes

paragraph Type: block Content: inline* (inline only — do not use block tags such as inside; use e.g. , , , …) Default paragraph. extraPlaceholder is an internal structure for the editor to show a ghost placeholder in empty “template” lines (ProseMirror JSON fragment or null). For normal agent output leave extraPlaceholder as null. Only set it if you are intentionally mirroring a field placeholder the user already has in the open editor; do not set random placeholder data for free-form answers. Atts:

extraPlaceholder: null

<p class="paragraph-base" extraplaceholder="null/some-value"></p>

heading Type: block Content: inline* (inline only — do not use block tags such as inside; use e.g. , , , …) Atts:

level: 1

<h1 class="heading-base"></h1>

bulletList Type: block list Content: listItem+ Atts: none

<ul class="list-base"><li></li></ul>

hardBreak Type: inline Atts: none

<br>

horizontalRule Type: block Atts: none

<hr class="hr-base">

orderedList Type: block list Content: listItem+ Atts:

start: 1
type: null

<ol class="order-list-base" type="null/some-value"><li></li></ol>

listItem Content: (paragraph|list)* (paragraphs and/or lists, in any order) Atts: none

<li></li>

blockquote Type: block Content: block+ (one or more block child nodes (e.g. paragraph, list, …)) Atts: none

<blockquote class="blockquote-base"><p class="paragraph-base"></p></blockquote>

Marks

link Atts:

href: null
target: _blank
rel: noopener noreferrer nofollow
class: null
title: null

<a target="_blank" rel="noopener noreferrer nofollow" href="">link text example</a>

bold Atts: none

<strong>bold text example</strong>

code Atts: none

<code>code text example</code>

italic Atts: none

<em>italic text example</em>

strike Atts: none

<s>strike text example</s>

underline Atts: none

<u>underline text example</u>

Show properties

One of:

string

string

object

object

mcpServersClaudeManagedMcpServerDto[]

Custom hosted MCP servers to attach to this Claude agent.

Show properties

Array of ClaudeManagedMcpServerDto

authModestring

Authentication mode for this MCP server.

Allowed:nonebeareroauth

bearerTokenstring | null

Bearer token to store for bearer-token MCP servers.

credentialConfiguredboolean

Whether Leadtime already has a stored credential for this MCP server.

idstring

Stable local id for an existing MCP row.

namestring

Display name for the MCP server. If omitted, Leadtime derives one from the URL.

oauthCredentialobject | null

OAuth credential details for an OAuth MCP server.

Show properties

accessTokenstring | null

clientIdstring | null

clientSecretstring | null

expiresAtstring | null

refreshTokenstring | null

scopestring | null

tokenEndpointstring | null

tokenEndpointAuthTypestring | null

Allowed:noneclient_secret_basicclient_secret_post

urlstringrequired

Hosted MCP server URL.

modelIdstring

Claude model id from the agent settings model cache/resources refresh, for example claude-sonnet-4-6 or claude-opus-4-8.

skillsClaudeManagedSkillRefDto[]

Skills attached to this Leadtime-managed Claude agent. Maximum 20. Only supported when agentSource is leadtimeManaged.

Show properties

Array of ClaudeManagedSkillRefDto

skillIdstringrequired

Anthropic built-in skill id (for example xlsx) or Leadtime workspace skill id for custom skills.

typestringrequired

Allowed:anthropiccustom

versionstring | null

Optional Anthropic skill version. Defaults to latest when omitted.

toolModestring

Leadtime MCP tool set exposed to Claude task sessions.

Allowed:basicfull

userVaultIdsstring[]

Additional user-managed Claude vault ids to attach to sessions.

enabledboolean

Enable or disable this agent connection.

providerApiKeyIdstring | null

Saved Anthropic provider API key id to use for this agent.

Responses

201

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*fieldsToReturnqueryComma-separated list of top-level response fields to return. Overrides the endpoint compact default unless responseShape=full is used.responseShapequeryAdvanced override. Omit for the endpoint compact default. Use full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.LT-Response-ShapeheaderAdvanced override. Set to full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Bodyapplication/json

anthropicApiKeystringRaw Anthropic API key. Prefer providerApiKeyId when a saved key exists.configstringClaude Managed configuration. Put model changes under config.managedAgent.modelId and GitHub defaults under config.githubRepositoryDefaults.enabledbooleanEnable or disable this agent connection.providerApiKeyIdstringSaved Anthropic provider API key id to use for this agent.

Request

curl -X POST "https://leadtime.app/api/public/agents/string/claude" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "anthropicApiKey": "string",
  "config": {
    "agentId": "string",
    "agentSource": "leadtimeManaged",
    "allowNetworkAccess": true,
    "customGuidance": "string",
    "environmentId": "string",
    "exposeRawApiCredentialToAgent": true,
    "githubRepositoryDefaults": [
      {
        "cloneUrl": "string",
        "fullName": "string",
        "id": 0,
        "name": "string",
        "private": true,
        "url": "string"
      }
    ],
    "managedAgent": {
      "instructions": "string",
      "mcpServers": [
        {
          "authMode": "none",
          "bearerToken": "string",
          "credentialConfigured": true,
          "id": "string",
          "name": "string",
          "oauthCredential": {
            "accessToken": "string",
            "clientId": "string",
            "clientSecret": "string",
            "expiresAt": "string",
            "refreshToken": "string",
            "scope": "string",
            "tokenEndpoint": "string",
            "tokenEndpointAuthType": "none"
          },
          "url": "string"
        }
      ],
      "modelId": "claude-sonnet-4-6",
      "skills": [
        {
          "skillId": "string",
          "type": "anthropic",
          "version": "string"
        }
      ]
    },
    "toolMode": "basic",
    "userVaultIds": [
      "string"
    ]
  },
  "enabled": true,
  "providerApiKeyId": "string"
}'

const response = await fetch("https://leadtime.app/api/public/agents/string/claude", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"anthropicApiKey\": \"string\",\n  \"config\": {\n    \"agentId\": \"string\",\n    \"agentSource\": \"leadtimeManaged\",\n    \"allowNetworkAccess\": true,\n    \"customGuidance\": \"string\",\n    \"environmentId\": \"string\",\n    \"exposeRawApiCredentialToAgent\": true,\n    \"githubRepositoryDefaults\": [\n      {\n        \"cloneUrl\": \"string\",\n        \"fullName\": \"string\",\n        \"id\": 0,\n        \"name\": \"string\",\n        \"private\": true,\n        \"url\": \"string\"\n      }\n    ],\n    \"managedAgent\": {\n      \"instructions\": \"string\",\n      \"mcpServers\": [\n        {\n          \"authMode\": \"none\",\n          \"bearerToken\": \"string\",\n          \"credentialConfigured\": true,\n          \"id\": \"string\",\n          \"name\": \"string\",\n          \"oauthCredential\": {\n            \"accessToken\": \"string\",\n            \"clientId\": \"string\",\n            \"clientSecret\": \"string\",\n            \"expiresAt\": \"string\",\n            \"refreshToken\": \"string\",\n            \"scope\": \"string\",\n            \"tokenEndpoint\": \"string\",\n            \"tokenEndpointAuthType\": \"none\"\n          },\n          \"url\": \"string\"\n        }\n      ],\n      \"modelId\": \"claude-sonnet-4-6\",\n      \"skills\": [\n        {\n          \"skillId\": \"string\",\n          \"type\": \"anthropic\",\n          \"version\": \"string\"\n        }\n      ]\n    },\n    \"toolMode\": \"basic\",\n    \"userVaultIds\": [\n      \"string\"\n    ]\n  },\n  \"enabled\": true,\n  \"providerApiKeyId\": \"string\"\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/agents/string/claude",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"anthropicApiKey\": \"string\",\n  \"config\": {\n    \"agentId\": \"string\",\n    \"agentSource\": \"leadtimeManaged\",\n    \"allowNetworkAccess\": true,\n    \"customGuidance\": \"string\",\n    \"environmentId\": \"string\",\n    \"exposeRawApiCredentialToAgent\": true,\n    \"githubRepositoryDefaults\": [\n      {\n        \"cloneUrl\": \"string\",\n        \"fullName\": \"string\",\n        \"id\": 0,\n        \"name\": \"string\",\n        \"private\": true,\n        \"url\": \"string\"\n      }\n    ],\n    \"managedAgent\": {\n      \"instructions\": \"string\",\n      \"mcpServers\": [\n        {\n          \"authMode\": \"none\",\n          \"bearerToken\": \"string\",\n          \"credentialConfigured\": true,\n          \"id\": \"string\",\n          \"name\": \"string\",\n          \"oauthCredential\": {\n            \"accessToken\": \"string\",\n            \"clientId\": \"string\",\n            \"clientSecret\": \"string\",\n            \"expiresAt\": \"string\",\n            \"refreshToken\": \"string\",\n            \"scope\": \"string\",\n            \"tokenEndpoint\": \"string\",\n            \"tokenEndpointAuthType\": \"none\"\n          },\n          \"url\": \"string\"\n        }\n      ],\n      \"modelId\": \"claude-sonnet-4-6\",\n      \"skills\": [\n        {\n          \"skillId\": \"string\",\n          \"type\": \"anthropic\",\n          \"version\": \"string\"\n        }\n      ]\n    },\n    \"toolMode\": \"basic\",\n    \"userVaultIds\": [\n      \"string\"\n    ]\n  },\n  \"enabled\": true,\n  \"providerApiKeyId\": \"string\"\n}",
)

Response

No example response.