DELETE/enterprises/{enterprise}/copilot/policies/coding_agent/organizations

Remove organizations from the enterprise coding agent policy

Disables Copilot cloud agent for the specified organizations within the enterprise.

The enterprise's coding agent policy must be set to enabled_for_selected_orgs before using this endpoint. Organizations can be specified by login or matched via custom properties.

Only organizations that have Copilot enabled and belong to the enterprise will be affected.

Only enterprise owners can remove organizations from the coding agent policy.

OAuth app tokens and personal access tokens (classic) need either the manage_billing:copilot or admin:enterprise scopes to use this endpoint.

RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 2 body fields

enterprisestringrequired

The slug version of the enterprise name.

The organizations to disable Copilot cloud agent for

organizationsarray<string>optional

List of organization logins within the enterprise to disable Copilot cloud agent for.

custom_propertiesarray<object>optional

List of custom property filters to match organizations. Organizations matching any of the specified property name/value pairs will be included. This is a one-time operation, setting the property on an organization in the future will not automatically update its coding agent policy.

2 status codes

204A header with no content is returned.

400Bad Request

messagestringoptional

documentation_urlstringoptional

urlstringoptional

statusstringoptional

Error handling

A 400 is returned: Bad Request.

import { Client } from "acme-sdk";

const client = new Client({
  baseUrl: "https://api.acme.com",
  auth: { bearer: process.env.API_TOKEN },
  retry: {
    maxAttempts: 3,
    retryOn: [
      408,
      425,
      429,
      500,
      502,
      503,
      504,
    ],
    backoffMs: 500,
    maxBackoffMs: 8000,
  },
  timeoutMs: 30000,
});

const result = await client.organizations.delete({
  enterprise: "example",
  organizations: "acme-inc",
  customProperties: [],
});

{
  "message": "This is an example message.",
  "documentation_url": "https://example.com",
  "url": "https://example.com",
  "status": "active"
}

Request

Response

Errors