Demote skill to private

Convert a Public (account) skill or deprecated legacy teamspace skill to Private (user) scope. Existing teamspace assignments are preserved. The caller must be the skill’s original author and administer skills in the account. Company copies of built-in skills cannot be demoted; use /reset instead. Requires ep:skills:write.

POST /skills/{skill_id}/demote

Demote skill to private

Python

import requests

url = "https://api.datagrid.com/v1/skills/{skill_id}/demote"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

200

{
  "object": "skill",
  "id": "<string>",
  "scope": "user",
  "category": "document_analysis",
  "slash_key": "<string>",
  "name": "<string>",
  "description": "<string>",
  "instructions": "<string>",
  "required_tools": [
    "<string>"
  ],
  "preferred_tools": [
    "<string>"
  ],
  "enabled": true,
  "account_id": "<string>",
  "builtin_key": "<string>",
  "promoted_at": "2023-11-07T05:31:56Z",
  "creator_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

skill_id · string · required

The ID of the skill to demote.

Response

200

application/json

Demoted skill (now user-scope)

object · enum<string> · required

The object type, always 'skill'.

Available options: skill

id · string · required

Unique identifier for the skill.

scope · enum<string> · required

Privacy scope. user = Private (author only), account = Public within the company, teamspace = deprecated legacy Public value retained only for compatibility, and builtin = global default. New skills never use teamspace; changing its privacy or assignments normalizes it.

Available options: user, account, teamspace, builtin

category · enum<string> · required

Category bucket for grouping in the skill picker.

Available options: document_analysis, construction_project_management, financial_analysis, estimation, quality_and_safety, scheduling, contracts_and_legal, data_and_reporting, research, communication, general_productivity

slash_key · string · required

The slash command key used to invoke this skill (e.g. budget-check).

name · string · required

Display name of the skill.

description · string · required

Short description shown in the skill picker.

instructions · string · required

The full instructions / system prompt for this skill.

required_tools · string[] · required

Tool identifiers that this skill requires to function.

preferred_tools · string[] · required

Tool identifiers that this skill works best with.

enabled · boolean · required

Whether the skill is active and available for selection. For a built-in skill, false when your company disabled it.

account_id · string | null · required

The account (company) that owns this skill. null for user-scope and builtin skills.

builtin_key · string | null · required

For built-in skills and company copies of them: the identifier of the built-in. null for user-authored skills.

promoted_at · string<date-time> | null · required

ISO timestamp when this skill was promoted to company scope. null for user-scope skills.

creator_id · string | null · required

ID of the user who created this skill. null for built-in skills that have never been edited.

created_at · string<date-time> · required

ISO timestamp when this skill was created.

updated_at · string<date-time> · required

ISO timestamp when this skill was last updated.