> ## Documentation Index > Fetch the complete documentation index at: https://docs.cotool.ai/llms.txt > Use this file to discover all available pages before exploring further. # Import skill > Import a skill package payload and create the skill. ## OpenAPI ````yaml https://app.cotool.ai/api/docs/openapi.json post /api/skills/import openapi: 3.1.0 info: title: Cotool API version: 1.0.0 description: >- # Cotool API Documentation The Cotool API allows you to interact with the Cotool platform programmatically, enabling you to build powerful integrations and automate your workflows. ## Getting an API Key Follow these steps to generate your API key: 1. **Log in** to the Cotool web interface 2. **Navigate** to `/settings/api-keys` 3. **Click** "Generate Key" 4. **Copy and store** your API key securely ⚠️ *It won't be shown again* ## API Key Authentication For programmatic access and integrations, use your API key with the Authorization header: ```http Authorization: Bearer your_api_key_here ``` ```bash curl -X GET "https://app.cotool.ai/api/endpoint" \ -H "Authorization: Bearer your_api_key_here" \ -H "Content-Type: application/json" ``` servers: - url: https://app.cotool.ai description: Production server security: - ApiKeyAuth: [] paths: /api/skills/import: post: tags: - Skills summary: Import skill description: Import a skill package payload and create the skill. requestBody: content: application/json: schema: type: object properties: name: type: string pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$ minLength: 1 maxLength: 64 description: Machine-safe skill name used in sandbox paths and imports userId: type: - string - 'null' format: uuid description: >- User owner for user-scoped skills; null or omitted creates an organization skill description: type: string minLength: 1 description: Description of what this skill teaches an agent to do instructionPrompt: type: string minLength: 1 description: Primary instruction prompt content for this skill requiredTools: type: array items: type: string description: Optional required tool types for this skill references: type: array items: type: object properties: filename: type: string description: Relative path from skill root directory: type: string enum: - references - assets - scripts description: Top-level skill directory where this file resides sizeBytes: type: integer minimum: 0 content: type: string description: File content (empty string allowed) required: - filename - content description: Optional references for initial version creation required: - name - description - instructionPrompt responses: '200': description: Successful response content: application/json: schema: type: object properties: id: type: string description: Unique identifier for the skill organizationId: type: string description: Unique identifier of the organization that owns this skill name: type: string pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$ minLength: 1 maxLength: 64 description: Machine-safe skill name used in sandbox paths and imports description: type: string description: Description of what this skill teaches an agent to do requiredTools: type: array items: type: string description: Optional required tool types for this skill userId: type: - string - 'null' description: >- User ID that owns this user-scoped skill, or null for organization skills createdByUserId: type: - string - 'null' description: >- User ID that created this skill, or null for system-created records createdAt: type: string description: Timestamp when the skill was created updatedAt: type: string description: Timestamp when the skill was last updated deletedAt: type: - string - 'null' description: >- Timestamp when the skill was soft-deleted, or null if active usedByAgentCount: type: number description: How many agents currently use this skill invocationCount30d: type: number description: >- Distinct chats in the last 30 days where an agent read this skill from the sandbox currentVersion: type: number description: Current version number of this skill instructionPrompt: type: string description: Primary instruction prompt content for this skill references: type: array items: type: object properties: id: type: string format: uuid description: Unique identifier for the reference file record skillVersionId: type: string format: uuid description: Version ID this reference belongs to filename: type: string description: >- Relative path from skill root (for example references/guide.md) directory: type: string enum: - references - assets - scripts description: Top-level skill directory where this file resides sizeBytes: type: integer minimum: 0 description: UTF-8 byte size of the file content content: type: string description: >- Optional file content (included in version detail / export flows) createdAt: type: string description: Timestamp when this file was stored required: - id - skillVersionId - filename - directory - sizeBytes description: Resource files for the active/current version required: - id - organizationId - name - description - requiredTools - userId - createdByUserId - createdAt - updatedAt - deletedAt - instructionPrompt '400': description: Bad request — input validation failed or the request was malformed content: application/json: schema: $ref: '#/components/schemas/ValidationError' '401': description: Unauthorized — missing or invalid API key / session content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Forbidden — the authenticated user lacks the required permissions content: application/json: schema: $ref: '#/components/schemas/PermissionError' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' x-codeSamples: - lang: shell label: cURL source: |- curl -X POST "https://app.cotool.ai/api/skills/import" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name":"string","userId":"string","description":"string","instructionPrompt":"string","requiredTools":["string"],"references":[{"filename":"string","directory":"references","sizeBytes":0,"content":"string"}]}' components: schemas: ValidationError: type: object properties: error: type: string description: Error message describing what went wrong issues: type: array description: >- Detailed validation issues, present when request or response schema validation fails items: type: object additionalProperties: true required: - error Error: type: object properties: error: type: string description: Error message describing what went wrong required: - error PermissionError: type: object properties: error: type: string description: Error message describing what went wrong missingPerms: type: array description: Permissions the authenticated user is missing for this operation items: type: string required: - error securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: API Key description: >- API Key authentication for programmatic access. Include your API key in the Authorization header as: `Bearer your_api_key_here` ````