> ## Documentation Index
> Fetch the complete documentation index at: https://developers.datagrid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Override built-in skill

> Create (or restore) a company-owned copy of a built-in skill that shadows the global default for your organization. Idempotent: if an override already exists it is returned unchanged; if it was previously removed it is restored. Requires `ep:skills:write` (account admin).



## OpenAPI

````yaml post /skills/builtin/{builtin_key}/override
openapi: 3.0.3
info:
  version: 0.1.1
  title: Datagrid API
  description: Datagrid API
servers:
  - url: https://api.datagrid.com/v1
security:
  - BearerAuth: []
paths:
  /skills/builtin/{builtin_key}/override:
    post:
      tags:
        - Skills
      summary: Override built-in skill
      description: >-
        Create (or restore) a company-owned copy of a built-in skill that
        shadows the global default for your organization. Idempotent: if an
        override already exists it is returned unchanged; if it was previously
        removed it is restored. Requires `ep:skills:write` (account admin).
      operationId: OverrideBuiltinSkill
      parameters:
        - name: builtin_key
          in: path
          required: true
          description: The built-in skill identifier (from `GET /skills/builtin`).
          schema:
            type: string
      responses:
        '200':
          description: The override skill (account-scope)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Skill'
        '403':
          description: Forbidden. Account admin required.
        '404':
          description: Built-in skill not found.
        '409':
          description: Conflict. A company skill already uses this built-in's slash key.
components:
  schemas:
    Skill:
      type: object
      required:
        - object
        - id
        - scope
        - category
        - slash_key
        - name
        - description
        - instructions
        - required_tools
        - preferred_tools
        - enabled
        - account_id
        - builtin_key
        - promoted_at
        - creator_id
        - created_at
        - updated_at
      properties:
        object:
          type: string
          enum:
            - skill
          description: The object type, always 'skill'.
        id:
          type: string
          description: Unique identifier for the skill.
        scope:
          type: string
          enum:
            - user
            - account
            - builtin
          description: >-
            Ownership scope. `user` = private (author only), `account` =
            company-owned, `builtin` = global default.
        category:
          type: string
          enum:
            - document_analysis
            - construction_project_management
            - financial_analysis
            - estimation
            - quality_and_safety
            - scheduling
            - contracts_and_legal
            - data_and_reporting
            - research
            - communication
            - general_productivity
          description: Category bucket for grouping in the skill picker.
        slash_key:
          type: string
          description: >-
            The slash command key used to invoke this skill (e.g.
            `budget-check`).
        name:
          type: string
          description: Display name of the skill.
        description:
          type: string
          description: Short description shown in the skill picker.
        instructions:
          type: string
          description: The full instructions / system prompt for this skill.
        required_tools:
          type: array
          items:
            type: string
          description: Tool identifiers that this skill requires to function.
        preferred_tools:
          type: array
          items:
            type: string
          description: Tool identifiers that this skill works best with.
        enabled:
          type: boolean
          description: Whether the skill is active and available for selection.
        account_id:
          type: string
          nullable: true
          description: >-
            The account (company) that owns this skill. `null` for `user`-scope
            and `builtin` skills.
        builtin_key:
          type: string
          nullable: true
          description: >-
            For company overrides of built-in skills: the identifier of the
            underlying built-in. `null` for user-authored skills.
        promoted_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            ISO timestamp when this skill was promoted to company scope. `null`
            for `user`-scope skills.
        creator_id:
          type: string
          nullable: true
          description: >-
            ID of the user who created this skill. `null` for built-in skills
            that have never been edited.
        created_at:
          type: string
          format: date-time
          description: ISO timestamp when this skill was created.
        updated_at:
          type: string
          format: date-time
          description: ISO timestamp when this skill was last updated.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````