Save native custom-agent settings for an agent

Saves custom instructions and selected workspace skill ids for a native custom agent running on Leadtime internal agent engine. Use this for normal custom agents. Send instructions under config.instructions and selected shared workspace skills under config.workspaceSkillIds. Do not use /agents/{id}/claude unless the agent is explicitly Anthropic/Claude Managed.

POST/agents/{id}/native

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

configNativeCustomAgentConfigDto

Show properties

defaultModelIdstring

Default native runtime model alias. Use auto unless the agent should prefer a specific catalog model.

Allowed:autogemini-3-flashclaude-haiku-4-5claude-sonnet-4-6claude-opus-4-8gemini-3-1-progemini-3-1-flash-litegemini-2-5-flashgpt-5-minigpt-5-5grok-4-3kimi-k2-6deepseek-v4-flashdeepseek-v4-proglm-5-2

instructionsobjectrequired

Required custom instructions for a native custom agent. Accepts Markdown, HTML, or ProseMirror IDoc JSON. These instructions are appended to the default Leadtime native agent prompt.

toolModestring

Leadtime tool exposure mode. Full mode gives the native Leadtime agent its normal Leadtime tools. Basic mode restricts Leadtime tools to task read/comment/status/assignee actions and task-bound time booking while keeping custom instructions, workspace skills, and custom MCP tools.

Allowed:basicfull

workspaceSkillIdsstring[]

Shared workspace agent skill ids selected for this native custom agent. Get or create skills through the workspace agent skills API, then save their UUIDs here.

enabledboolean

Deprecated compatibility field. Pause/resume agents with the normal agent status endpoint instead of a separate native-agent enabled flag.

Responses

201

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X POST "https://leadtime.app/api/public/agents/string/native" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "config": {
    "defaultModelId": "auto",
    "instructions": {},
    "toolMode": "basic",
    "workspaceSkillIds": [
      "string"
    ]
  },
  "enabled": true
}'

const response = await fetch("https://leadtime.app/api/public/agents/string/native", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "config": {
    "defaultModelId": "auto",
    "instructions": {},
    "toolMode": "basic",
    "workspaceSkillIds": [
      "string"
    ]
  },
  "enabled": true
})
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/agents/string/native",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "config": {
    "defaultModelId": "auto",
    "instructions": {},
    "toolMode": "basic",
    "workspaceSkillIds": [
      "string"
    ]
  },
  "enabled": True
},
)

Response

No example response.