Update Project Skill

POST

/org/:org_id/project/:project_id/skill/:skill_id

POST

/api/v1/org/:org_id/project/:project_id/skill/:skill_id

curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/skill/skill_id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "display_name": "Refund Policy (EMEA)",
  "description": "How to decide whether a refund request qualifies in EMEA."
}'

{
  "id": "019d6b01-1a10-7001-8b1a-2a5c9d4e1001",
  "slug": "refund-policy",
  "display_name": "Refund Policy (EMEA)",
  "description": "How to decide whether a refund request qualifies in EMEA.",
  "license": null,
  "compatibility": null,
  "source": {
    "id": "019d6a00-1a10-7003-8b1a-2a5c9d4e0003",
    "name": "custom",
    "description": "User-created skills",
    "url": null
  },
  "tags": [],
  "has_active_revision": true,
  "has_capabilities": false,
  "requires_prerequisites": false,
  "active_revision": {
    "id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
    "annotation": "Clarified the escalation path.",
    "created": "2026-07-21T15:40:00Z"
  },
  "created": "2026-07-14T09:12:00Z",
  "modified": "2026-07-21T15:40:00Z",
  "project_id": "0190a234-9876-5432-10ab-cdef01234567",
  "created_by_user_id": "0190c234-1111-2222-3333-444444444444"
}

Update project-scoped skill metadata.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

skill_idstringRequiredformat: "uuid"

The skill ID

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

Request

This endpoint expects an object.

slugstring or nullOptional

display_namestring or nullOptional<=255 characters

descriptionstring or nullOptional<=1024 characters

licensestring or nullOptional<=255 characters

compatibilitystring or nullOptional<=500 characters

Response

Project skill updated

idstringformat: "uuid"

slugstring

display_namestring

descriptionstring or null

licensestring or null

compatibilitystring or null

sourceobject

tagslist of strings

has_active_revisionboolean

has_capabilitiesboolean

requires_prerequisitesboolean

active_revisionobject or null

createdstring

modifiedstring

project_idstringformat: "uuid"

created_by_user_idstring or nullformat: "uuid"

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error