> ## 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

> Restore a built-in skill your company removed. Clears only the removal, so a built-in that was disabled before it was removed comes back disabled. No copy of the built-in is created: the response is the skill your company now gets — the global built-in (its `id` is the built-in's) with your company's state applied, or your company's own copy if it has one. Idempotent: returns the same skill when nothing was removed. 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: >-
        Restore a built-in skill your company removed. Clears only the removal,
        so a built-in that was disabled before it was removed comes back
        disabled. No copy of the built-in is created: the response is the skill
        your company now gets — the global built-in (its `id` is the built-in's)
        with your company's state applied, or your company's own copy if it has
        one. Idempotent: returns the same skill when nothing was removed.
        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 skill your company gets for this built-in
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Skill'
        '403':
          description: Forbidden. Account admin required.
        '404':
          description: Built-in skill not found.
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
            - teamspace
            - builtin
          description: >-
            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.
        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. For a
            built-in skill, `false` when your company disabled it.
        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 built-in skills and company copies of them: the identifier of
            the 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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.