Create Skill

{
  "skill": {
    "created_at": "2024-01-15T09:30:00Z",
    "created_by": "string",
    "current_version_id": "string",
    "description": "string",
    "id": "string",
    "is_active": true,
    "is_global": true,
    "is_live": true,
    "name": "string",
    "reach": {
      "group_ids": [
        "string"
      ],
      "person_ids": [
        "string"
      ],
      "pinned_person_ids": [
        "string"
      ],
      "scope": "ORG"
    },
    "referenced_connectors": [
      "string"
    ],
    "slug": "string",
    "source": "AUTHORED",
    "updated_at": "2024-01-15T09:30:00Z",
    "visibility": "ORG"
  },
  "version": {
    "checksum": "string",
    "created_at": "2024-01-15T09:30:00Z",
    "description": "string",
    "file_sizes": {},
    "id": "string",
    "manifest": [
      "string"
    ],
    "name": "string",
    "referenced_connectors": [
      "string"
    ],
    "rejection_reason": "string",
    "release_notes": "string",
    "reviewed_at": "2024-01-15T09:30:00Z",
    "reviewed_by": "string",
    "size_bytes": 1,
    "status": "DRAFT",
    "uploaded_by": "string",
    "version_number": 1
  }
}

Multipart file and form fields; dry_run validates the bundle and returns a preview without storing anything.

Requires the manage_skills permission.

Authentication

AuthorizationBearer

An organization API key (mfw_org_key_...), sent as Authorization: Bearer <key>. Create one under Settings → API keys.

Query parameters

dry_runbooleanOptionalDefaults to false

Response

Successful Response

SkillUploadResponseobject

SkillPreviewobject

A validated bundle’s metadata; nothing is stored.

Errors

422

Unprocessable Entity Error