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

# Put Team Skill

> Create one of your team's skills (no `version`), or replace it at the `version` a read returned. A team owner
or an organization admin can; an API key can when the person who created it can, as they stand now.



## OpenAPI

````yaml https://api.sixtyfour.ai/openapi.json put /skills/{name}
openapi: 3.1.0
info:
  title: Sixtyfour API
  description: >-
    Intelligence API for People and Entities. Deploy AI agents that investigate,
    resolve identities, map relationships, and surface risk signals
  contact:
    name: Sixtyfour
    url: https://sixtyfour.ai/
    email: support@sixtyfour.ai
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sixtyfour.ai
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Enrichment
    description: Find and enrich emails, phones, and LinkedIn for people and companies.
  - name: org-chart
    description: Discover people inside a company and build org charts.
  - name: Search
    description: Run deep and filter searches over Sixtyfour's data.
  - name: Workflow
    description: Create, run, and manage enrichment workflows.
  - name: Workflow Schedules
    description: Create and manage recurring schedules for workflows.
  - name: Account
    description: Manage and inspect your account and credit balance.
  - name: Intelligence
    description: Verify identity attributes such as age using high-tier OSINT research.
  - name: Atlas
    description: >-
      Read your Atlas investigations: attribution graph, workspace files,
      reports, and exports.
paths:
  /skills/{name}:
    put:
      tags:
        - Skills
      summary: Put Team Skill
      description: >-
        Create one of your team's skills (no `version`), or replace it at the
        `version` a read returned. A team owner

        or an organization admin can; an API key can when the person who created
        it can, as they stand now.
      operationId: put_team_skill_skills__name__put
      parameters:
        - name: name
          in: path
          required: true
          schema:
            type: string
            title: Name
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SkillPut'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TeamSkill'
        '400':
          description: Request was rejected by the route's validation rules.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                type: object
              example:
                detail: Invalid request body
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                type: object
              example:
                detail: Invalid API key
        '403':
          description: Organization access is locked.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                type: object
              example:
                detail: >-
                  This organization no longer has access to Sixtyfour. Contact
                  your representative at Sixtyfour.
        '422':
          description: Request body failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Unexpected server error. Retry with backoff.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                type: object
              example:
                detail: Internal server error
        '503':
          description: >-
            The API key could not be checked, or the request could not be
            started, because a backing service is briefly unavailable or at
            capacity. Nothing was charged. Retry after the `Retry-After` header.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                type: object
              example:
                detail: Could not verify the API key right now. Retry shortly.
components:
  schemas:
    SkillPut:
      properties:
        markdown:
          type: string
          maxLength: 24000
          title: Markdown
          description: >-
            The whole skill: YAML frontmatter with `name` (the name in the path)
            and `description` (when an agent should read it, at most 500
            characters), then its instructions. At most 24,000 characters.
        version:
          anyOf:
            - type: string
              maxLength: 200
            - type: 'null'
          title: Version
          description: >-
            The version this replaces, as a read returned it. Leave it out to
            create the skill.
      additionalProperties: false
      type: object
      required:
        - markdown
      title: SkillPut
    TeamSkill:
      properties:
        name:
          type: string
          title: Name
          description: The skill's name. A run names it as `team/<name>`.
        description:
          type: string
          title: Description
          description: 'When an agent should read it: the line every run of the team lists.'
        markdown:
          type: string
          title: Markdown
          description: 'The whole skill as saved: its frontmatter, then its instructions.'
        version:
          type: string
          title: Version
          description: >-
            Its current version. A replace or delete names it, and is refused
            once it changed.
      type: object
      required:
        - name
        - description
        - markdown
        - version
      title: TeamSkill
    HTTPValidationError:
      title: HTTPValidationError
      type: object
      properties:
        detail:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
      example:
        detail:
          - loc:
              - body
              - target_company
              - domain
            msg: Field required
            type: missing
            input: null
            ctx: {}
    ValidationError:
      title: ValidationError
      type: object
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          type: array
          items:
            oneOf:
              - type: string
              - type: integer
          description: Path to the field that failed validation.
          example:
            - body
            - target_company
            - domain
        msg:
          type: string
          description: Human-readable error message.
          example: Field required
        type:
          type: string
          description: Error code (e.g. 'missing', 'value_error').
          example: missing
        input:
          description: The offending input value (any type, may be null).
          nullable: true
          example: null
        ctx:
          type: object
          description: Optional error context.
          additionalProperties: true
          example: {}
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Sixtyfour API key.
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        An OAuth access token from `POST /oauth/token`, sent as `Authorization:
        Bearer <token>`. An API key sent as a bearer token is refused with 401.
        When both headers are sent, the bearer token is used.

````

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