Update Skill

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

Edits the display fields in place, changes who the skill reaches, and is_active publishes a draft, republishes or unpublishes.

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.

Path parameters

slugstringRequired

Request

This endpoint expects an object.

namestring or nullOptional1-255 characters

descriptionstring or nullOptional<=1024 characters

referenced_connectorslist of strings or nullOptional

is_activeboolean or nullOptional

access_scopeenum or nullOptional

Who an organization skill reaches: everyone, some Groups, or only its author.

Allowed values:

group_idslist of strings or nullOptional

Response

Successful Response

idstringformat: "uuid"

slugstring

namestring

descriptionstring

referenced_connectorslist of strings

sourceenum

Organization skills are AUTHORED; Merge’s global skills are EXAMPLE or AUTO_GENERATED.

Allowed values:

is_globalboolean

created_bystring or nullformat: "uuid"

current_version_idstring or nullformat: "uuid"

is_activeboolean

is_liveboolean

visibilityenum

PERSONAL skills reach only their author; ORG covers both organization-wide and Group reach.

Allowed values:

reachobject or null

scope is None for a global this organization hasn't enabled.

created_atdatetime

updated_atdatetime

versionslist of objects

Errors

422

Unprocessable Entity Error