Launch Week 02 wrapped — explore all five launches
Confident AI
Docs
Pricing
Products
LLM Evaluation
LLM Evaluation

Benchmark LLM systems with research-backed metrics.

LLM Observability
LLM Observability

Trace, monitor, and alert on production LLM systems.

AI Red Teaming
AI Red Teaming

Stress-test LLM apps against adversarial attacks.

AI Governance
AI Governance

Enforce AI standards and controls across teams.

Book a DemoSign Up
Book a DemoSign Up

Update Skill

PUThttps://api.confident-ai.com/v2/organization/governance-policies/{policyId}/skill

Sets the Agent Skill served to coding agents working on the projects this governance policy governs, creating it when the policy has none and replacing it outright otherwise. Both description and body are required and must not be blank, so there is no way to patch one and leave the other. The new text reaches an agent the next time it clones the project's Agent Skills repository, where it appears as skills/governance/SKILL.md. Returns the skill as it now stands, which is never null.

PUT/v2/organization/governance-policies/{policyId}/skill
curl -X PUT "https://api.confident-ai.com/v2/organization/governance-policies/{policyId}/skill" \
  -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Rules for shipping changes to an AI system governed for EU AI Act readiness.",
  "body": "## Before opening a pull request\n\n- Run the project'\''s evals and attach the test run link.\n- Never disable a governance control to make a build pass.\n"
}'
200
{
  "success": true,
  "data": {
    "description": "Rules for shipping changes to an AI system governed for EU AI Act readiness.",
    "body": "## Before opening a pull request\n\n- Run the project's evals and attach the test run link.\n- Never disable a governance control to make a build pass.\n"
  },
  "link": "https://app.confident-ai.com/organization/<ORGANIZATION-ID>/governance/policies/<GOVERNANCE-POLICY-ID>",
  "deprecated": false
}

Headers

  • CONFIDENT_API_KEYstringRequired

    The organization API key for your Confident AI organization.

Path parameters

  • policyIdstringRequired

    The id of the governance policy.

Request body

  • descriptionstringRequired

    One line on what the skill covers, which is how a coding agent decides whether it is relevant. Required, and must not be blank.

  • bodystringRequired

    The instructions themselves, in Markdown, which become the body of skills/governance/SKILL.md. Required, and must not be blank.

Response

Update Skill succeeded.

  • successboolean

    Indicates if the request was successful.

  • dataobject

    An Agent Skill attached to a governance policy: the instructions Confident AI serves to coding agents working on the projects the policy governs. Confident AI publishes a per-project Agent Skills git repository at https://app.confident-ai.com/skills.git, and a project enrolled in this policy finds the skill there as skills/governance/SKILL.md, with description in the YAML frontmatter and body as the Markdown beneath it. Nothing about the skill is assessed — it instructs the agent, it is not a control.

    Show 2 propertiesHide 2 properties

    • descriptionstring

      One line on what the skill covers, which is how a coding agent decides whether it is relevant to the task in front of it.

    • bodystring

      The instructions themselves, in Markdown. This becomes the body of the SKILL.md file, so write it for a coding agent rather than a person and be as explicit as the policy requires.

  • linkstring

    This is the URL of the resource on the Confident AI platform.

  • deprecatedboolean

    Indicates if this endpoint is deprecated.

Built byConfident AI