Skip to main content
⚠️ Using our API via a dedicated deployment? Just replace api.langdock.com with your deployment’s base URL: <deployment-url>/api/public
This is the new Agents API with native Vercel AI SDK compatibility. If you’re using the legacy Assistants API, see the migration guide.
Enables or disables an agent in your workspace. Disabled agents cannot be used by workspace members until re-enabled.
This is an administrative action. Only workspace admins or users with appropriate permissions can disable/enable agents.

​
Use Cases

  • Temporarily disable an agent that needs maintenance or updates
  • Re-enable a previously disabled agent
  • Control agent availability during rollouts or testing

​
Request Parameters

ParameterTypeRequiredDescription
agentIdstringYesUUID of the agent to enable/disable
disabledbooleanYestrue to disable, false to enable

​
Example

const axios = require("axios");

async function toggleAgentStatus(agentId, disabled) {
  const response = await axios.patch(
    "https://api.langdock.com/agent/v1/disable",
    {
      agentId: agentId,
      disabled: disabled
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log(`Agent ${disabled ? 'disabled' : 'enabled'}:`, response.data);
}

// Disable an agent
toggleAgentStatus("550e8400-e29b-41d4-a716-446655440000", true);

// Re-enable an agent
toggleAgentStatus("550e8400-e29b-41d4-a716-446655440000", false);

​
Response Format

​
Success Response (200 OK)

{
  status: "success";
  message: "Agent disabled successfully" | "Agent enabled successfully";
}

​
Error Handling

Status CodeDescription
400Invalid parameters (missing agentId or disabled)
401Invalid or missing API key
403Insufficient permissions to disable agents
404Agent not found or API key does not have access
429Rate limit exceeded

​
Behavior

When an agent is disabled:
  • Users cannot start new conversations with the agent
  • The agent does not appear in the agent library for regular users
  • Existing conversations may still be viewable but the agent cannot respond
  • Admins can still view and manage the agent
  • The agent can be re-enabled at any time
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.