Llm

For instructions on how to authenticate to use this endpoint, see API overview.

Endpoints

GET
POST
GET
POST
GET
POST
GET
PATCH
POST
POST
GET
POST
POST
GET
DELETE
POST
POST
GET
GET
GET

List all llm skills

Required API key scopes

llm_skill:read

Query parameters

  • category
    string
  • created_by_id
    integer
  • limit
    integer
  • offset
    integer
  • owner_id
    integer
  • search
    string

Response


Example request

GET /api/projects/:project_id/llm_skills
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/

Example response

Status 200
RESPONSE
{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "description": "string",
      "license": "string",
      "compatibility": "string",
      "allowed_tools": [
        "string"
      ],
      "metadata": {},
      "category": "string",
      "owners": [
        {
          "id": 0,
          "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
          "distinct_id": "string",
          "first_name": "string",
          "last_name": "string",
          "email": "user@example.com",
          "is_email_verified": true,
          "hedgehog_config": {},
          "role_at_organization": "engineering"
        }
      ],
      "outline": [
        {
          "level": 1,
          "text": "string"
        }
      ],
      "spec_problems": [
        {
          "code": "string",
          "message": "string",
          "file_path": "string"
        }
      ],
      "version": 0,
      "version_description": "string",
      "created_by": {
        "id": 0,
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "distinct_id": "string",
        "first_name": "string",
        "last_name": "string",
        "email": "user@example.com",
        "is_email_verified": true,
        "hedgehog_config": {},
        "role_at_organization": "engineering"
      },
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "deleted": true,
      "is_latest": true,
      "latest_version": 0,
      "version_count": 0,
      "first_version_created_at": "string"
    }
  ]
}
Status 304 Not modified. The client sent an If-None-Match that matches the current list.

Create llm skills

Required API key scopes

llm_skill:write

Request parameters

  • name
    string
  • description
    string
  • body
    string
  • license
    string
  • compatibility
    string
  • allowed_tools
    array
  • metadata
    object
  • owners
    array
  • files
    Click to open
    array

Response


Example request

POST /api/projects/:project_id/llm_skills
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/\
	-d name="string",\
	-d description="string",\
	-d body="string"

Example response

Status 201
RESPONSE
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "body_total_length": 0,
  "body_next_offset": 0,
  "body": "string",
  "license": "string",
  "compatibility": "string",
  "allowed_tools": [
    "string"
  ],
  "metadata": {},
  "category": "string",
  "owners": [
    {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    }
  ],
  "files": [
    {
      "path": "string",
      "content_type": "string",
      "line_count": 0,
      "char_count": 0,
      "size": 0,
      "sha256": "string"
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "string"
    }
  ],
  "spec_problems": [
    {
      "code": "string",
      "message": "string",
      "file_path": "string"
    }
  ],
  "version": 0,
  "version_description": "string",
  "created_by": {
    "id": 0,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "distinct_id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "is_email_verified": true,
    "hedgehog_config": {},
    "role_at_organization": "engineering"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "is_latest": true,
  "latest_version": 0,
  "version_count": 0,
  "first_version_created_at": "string"
}

Retrieve llm skills bundle

One zip of the requesting user's store skills, for unpacking into a skills directory.

Required API key scopes

llm_skill:read

Query parameters

  • content
    string
    Default: stub
    One of: "stub""full"
  • limit
    integer
    Default: 50

Example request

GET /api/projects/:project_id/llm_skills/bundle
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/bundle/

Example response

Status 200

Create llm skills import

Required API key scopes

llm_skill:write

Response


Example request

Example response

Status 201
RESPONSE
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "body_total_length": 0,
  "body_next_offset": 0,
  "body": "string",
  "license": "string",
  "compatibility": "string",
  "allowed_tools": [
    "string"
  ],
  "metadata": {},
  "category": "string",
  "owners": [
    {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    }
  ],
  "files": [
    {
      "path": "string",
      "content_type": "string",
      "line_count": 0,
      "char_count": 0,
      "size": 0,
      "sha256": "string"
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "string"
    }
  ],
  "spec_problems": [
    {
      "code": "string",
      "message": "string",
      "file_path": "string"
    }
  ],
  "version": 0,
  "version_description": "string",
  "created_by": {
    "id": 0,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "distinct_id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "is_email_verified": true,
    "hedgehog_config": {},
    "role_at_organization": "engineering"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "is_latest": true,
  "latest_version": 0,
  "version_count": 0,
  "first_version_created_at": "string"
}

Retrieve llm skills marketplace install command

Report whether the user already has a marketplace credential, without minting one.

The token is unrecoverable, so an existing credential returns its mask only — the UI shows "already connected, existing setups keep working" and offers an explicit rotate.

Required API key scopes

llm_skill:read

Response


Example request

GET /api/projects/:project_id/llm_skills/marketplace/install-command
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/marketplace/install-command/

Example response

Status 200
RESPONSE
{
  "status": "absent",
  "connected": true,
  "plugin_name": "string",
  "marketplace_name": "string",
  "label": "string",
  "repo_url": "string",
  "command": "string",
  "command_template": "string",
  "codex_command": "string",
  "codex_command_template": "string",
  "token": "string",
  "mask_value": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "last_rolled_at": "2019-08-24T14:15:22Z"
}

Create llm skills marketplace install command

Mint the user's read-only marketplace credential (or rotate it) and return the install command.

Per-user: rotating only ever invalidates this user's own credential, never a teammate's.

Required API key scopes

llm_skill:write

Request parameters

  • rotate
    boolean
    Default: false

Response


Example request

POST /api/projects/:project_id/llm_skills/marketplace/install-command
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/marketplace/install-command/\
	-d rotate="boolean"

Example response

Status 200
RESPONSE
{
  "status": "absent",
  "connected": true,
  "plugin_name": "string",
  "marketplace_name": "string",
  "label": "string",
  "repo_url": "string",
  "command": "string",
  "command_template": "string",
  "codex_command": "string",
  "codex_command_template": "string",
  "token": "string",
  "mask_value": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "last_rolled_at": "2019-08-24T14:15:22Z"
}

Retrieve llm skills name

Required API key scopes

llm_skill:read

Path parameters

  • skill_name
    string

Query parameters

  • body_length
    integer
  • body_offset
    integer
  • version
    integer

Response


Example request

GET /api/projects/:project_id/llm_skills/name/:skill_name
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/

Example response

Status 200
RESPONSE
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "body_total_length": 0,
  "body_next_offset": 0,
  "body": "string",
  "license": "string",
  "compatibility": "string",
  "allowed_tools": [
    "string"
  ],
  "metadata": {},
  "category": "string",
  "owners": [
    {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    }
  ],
  "files": [
    {
      "path": "string",
      "content_type": "string",
      "line_count": 0,
      "char_count": 0,
      "size": 0,
      "sha256": "string"
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "string"
    }
  ],
  "spec_problems": [
    {
      "code": "string",
      "message": "string",
      "file_path": "string"
    }
  ],
  "version": 0,
  "version_description": "string",
  "created_by": {
    "id": 0,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "distinct_id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "is_email_verified": true,
    "hedgehog_config": {},
    "role_at_organization": "engineering"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "is_latest": true,
  "latest_version": 0,
  "version_count": 0,
  "first_version_created_at": "string"
}

Update llm skills name

Required API key scopes

llm_skill:write

Path parameters

  • skill_name
    string

Request parameters

  • body
    string
  • edits
    Click to open
    array
  • description
    string
  • license
    string
  • compatibility
    string
  • allowed_tools
    array
  • metadata
    object
  • files
    Click to open
    array
  • file_edits
    Click to open
    array
  • owners
    array
  • base_version
    integer
  • version_description
    string

Response


Example request

PATCH /api/projects/:project_id/llm_skills/name/:skill_name
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl -X PATCH \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/\
	-d body="string"

Example response

Status 200
RESPONSE
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "body_total_length": 0,
  "body_next_offset": 0,
  "body": "string",
  "license": "string",
  "compatibility": "string",
  "allowed_tools": [
    "string"
  ],
  "metadata": {},
  "category": "string",
  "owners": [
    {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    }
  ],
  "files": [
    {
      "path": "string",
      "content_type": "string",
      "line_count": 0,
      "char_count": 0,
      "size": 0,
      "sha256": "string"
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "string"
    }
  ],
  "spec_problems": [
    {
      "code": "string",
      "message": "string",
      "file_path": "string"
    }
  ],
  "version": 0,
  "version_description": "string",
  "created_by": {
    "id": 0,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "distinct_id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "is_email_verified": true,
    "hedgehog_config": {},
    "role_at_organization": "engineering"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "is_latest": true,
  "latest_version": 0,
  "version_count": 0,
  "first_version_created_at": "string"
}

Create llm skills name archive

Required API key scopes

llm_skill:write

Path parameters

  • skill_name
    string

Example request

POST /api/projects/:project_id/llm_skills/name/:skill_name/archive
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/archive/

Example response

Status 204 No response body
Status 403 Another product owns what this skill runs and refuses this caller's archive.

Create llm skills name duplicate

Required API key scopes

llm_skill:write

Path parameters

  • skill_name
    string

Request parameters

  • new_name
    string

Response


Example request

POST /api/projects/:project_id/llm_skills/name/:skill_name/duplicate
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/duplicate/\
	-d new_name="string"

Example response

Status 201
RESPONSE
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "body_total_length": 0,
  "body_next_offset": 0,
  "body": "string",
  "license": "string",
  "compatibility": "string",
  "allowed_tools": [
    "string"
  ],
  "metadata": {},
  "category": "string",
  "owners": [
    {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    }
  ],
  "files": [
    {
      "path": "string",
      "content_type": "string",
      "line_count": 0,
      "char_count": 0,
      "size": 0,
      "sha256": "string"
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "string"
    }
  ],
  "spec_problems": [
    {
      "code": "string",
      "message": "string",
      "file_path": "string"
    }
  ],
  "version": 0,
  "version_description": "string",
  "created_by": {
    "id": 0,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "distinct_id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "is_email_verified": true,
    "hedgehog_config": {},
    "role_at_organization": "engineering"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "is_latest": true,
  "latest_version": 0,
  "version_count": 0,
  "first_version_created_at": "string"
}

Retrieve llm skills name export

Path parameters

  • skill_name
    string

Query parameters

  • version
    integer

Example request

GET /api/projects/:project_id/llm_skills/name/:skill_name/export
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/export/

Example response

Status 200

Create llm skills name files

Required API key scopes

llm_skill:write

Path parameters

  • skill_name
    string

Request parameters

  • path
    string
  • content
    string
  • content_type
    string
    Default: text/plain
  • base_version
    integer

Response


Example request

POST /api/projects/:project_id/llm_skills/name/:skill_name/files
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/files/\
	-d path="string",\
	-d content="string"

Example response

Status 201
RESPONSE
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "body_total_length": 0,
  "body_next_offset": 0,
  "body": "string",
  "license": "string",
  "compatibility": "string",
  "allowed_tools": [
    "string"
  ],
  "metadata": {},
  "category": "string",
  "owners": [
    {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    }
  ],
  "files": [
    {
      "path": "string",
      "content_type": "string",
      "line_count": 0,
      "char_count": 0,
      "size": 0,
      "sha256": "string"
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "string"
    }
  ],
  "spec_problems": [
    {
      "code": "string",
      "message": "string",
      "file_path": "string"
    }
  ],
  "version": 0,
  "version_description": "string",
  "created_by": {
    "id": 0,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "distinct_id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "is_email_verified": true,
    "hedgehog_config": {},
    "role_at_organization": "engineering"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "is_latest": true,
  "latest_version": 0,
  "version_count": 0,
  "first_version_created_at": "string"
}

Create llm skills name files rename

Required API key scopes

llm_skill:write

Path parameters

  • skill_name
    string

Request parameters

  • old_path
    string
  • new_path
    string
  • base_version
    integer

Response


Example request

POST /api/projects/:project_id/llm_skills/name/:skill_name/files-rename
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/files-rename/\
	-d old_path="string",\
	-d new_path="string"

Example response

Status 200
RESPONSE
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "body_total_length": 0,
  "body_next_offset": 0,
  "body": "string",
  "license": "string",
  "compatibility": "string",
  "allowed_tools": [
    "string"
  ],
  "metadata": {},
  "category": "string",
  "owners": [
    {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    }
  ],
  "files": [
    {
      "path": "string",
      "content_type": "string",
      "line_count": 0,
      "char_count": 0,
      "size": 0,
      "sha256": "string"
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "string"
    }
  ],
  "spec_problems": [
    {
      "code": "string",
      "message": "string",
      "file_path": "string"
    }
  ],
  "version": 0,
  "version_description": "string",
  "created_by": {
    "id": 0,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "distinct_id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "is_email_verified": true,
    "hedgehog_config": {},
    "role_at_organization": "engineering"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "is_latest": true,
  "latest_version": 0,
  "version_count": 0,
  "first_version_created_at": "string"
}

Retrieve llm skills name files

Required API key scopes

llm_skill:read

Path parameters

  • file_path
    string
  • skill_name
    string

Query parameters

  • version
    integer

Response


Example request

GET /api/projects/:project_id/llm_skills/name/:skill_name/files/:file_path
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/files/:file_path/

Example response

Status 200
RESPONSE
{
  "path": "string",
  "content": "string",
  "content_type": "string"
}

Delete llm skills name files

Required API key scopes

llm_skill:write

Path parameters

  • file_path
    string
  • skill_name
    string

Query parameters

  • base_version
    integer

Response


Example request

DELETE /api/projects/:project_id/llm_skills/name/:skill_name/files/:file_path
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl  -X DELETE \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/files/:file_path/

Example response

Status 200
RESPONSE
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "body_total_length": 0,
  "body_next_offset": 0,
  "body": "string",
  "license": "string",
  "compatibility": "string",
  "allowed_tools": [
    "string"
  ],
  "metadata": {},
  "category": "string",
  "owners": [
    {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    }
  ],
  "files": [
    {
      "path": "string",
      "content_type": "string",
      "line_count": 0,
      "char_count": 0,
      "size": 0,
      "sha256": "string"
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "string"
    }
  ],
  "spec_problems": [
    {
      "code": "string",
      "message": "string",
      "file_path": "string"
    }
  ],
  "version": 0,
  "version_description": "string",
  "created_by": {
    "id": 0,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "distinct_id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "is_email_verified": true,
    "hedgehog_config": {},
    "role_at_organization": "engineering"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "is_latest": true,
  "latest_version": 0,
  "version_count": 0,
  "first_version_created_at": "string"
}

Create llm skills name publish community

Required API key scopes

llm_skill:write

Path parameters

  • skill_name
    string

Request parameters

  • expected_skill_id
    string
  • expected_version
    integer
  • expected_category
    string
  • scout_config
  • display_name
  • tags
    array
  • author_handle

Response


Example request

POST /api/projects/:project_id/llm_skills/name/:skill_name/publish-community
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/publish-community/\
	-d expected_skill_id="string",\
	-d expected_version="integer"

Example response

Status 201
RESPONSE
{
  "pr_url": "http://example.com",
  "pr_number": 0,
  "branch": "string"
}
Status 409
RESPONSE
{
  "detail": "string"
}

Create llm skills name rename

Required API key scopes

llm_skill:write

Path parameters

  • skill_name
    string

Request parameters

  • new_name
    string

Response


Example request

POST /api/projects/:project_id/llm_skills/name/:skill_name/rename
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl 
    -H 'Content-Type: application/json'\
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/rename/\
	-d new_name="string"

Example response

Status 200
RESPONSE
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "body_total_length": 0,
  "body_next_offset": 0,
  "body": "string",
  "license": "string",
  "compatibility": "string",
  "allowed_tools": [
    "string"
  ],
  "metadata": {},
  "category": "string",
  "owners": [
    {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    }
  ],
  "files": [
    {
      "path": "string",
      "content_type": "string",
      "line_count": 0,
      "char_count": 0,
      "size": 0,
      "sha256": "string"
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "string"
    }
  ],
  "spec_problems": [
    {
      "code": "string",
      "message": "string",
      "file_path": "string"
    }
  ],
  "version": 0,
  "version_description": "string",
  "created_by": {
    "id": 0,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "distinct_id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "is_email_verified": true,
    "hedgehog_config": {},
    "role_at_organization": "engineering"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true,
  "is_latest": true,
  "latest_version": 0,
  "version_count": 0,
  "first_version_created_at": "string"
}
Status 403 Another product owns what this skill runs and refuses this caller's rename.

Retrieve llm skills name skill md

The rendered SKILL.md plus its frontmatter as JSON, for a host that serves the file.

Both halves come from one renderer, so a digest a client takes over content still describes the fields it reads from frontmatter.

Required API key scopes

llm_skill:read

Path parameters

  • skill_name
    string

Query parameters

  • version
    integer

Response


Example request

GET /api/projects/:project_id/llm_skills/name/:skill_name/skill-md
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/name/:skill_name/skill-md/

Example response

Status 200
RESPONSE
{
  "name": "string",
  "version": 0,
  "content": "string",
  "frontmatter": {
    "name": "string",
    "description": "string",
    "license": "string",
    "compatibility": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "allowed-tools": "string"
  }
}

Retrieve llm skills resolve name

Required API key scopes

llm_skill:read

Path parameters

  • skill_name
    string

Query parameters

  • before_version
    integer
  • limit
    integer
    Default: 50
  • offset
    integer
  • version
    integer
  • version_id
    string

Response


Example request

GET /api/projects/:project_id/llm_skills/resolve/name/:skill_name
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/llm_skills/resolve/name/:skill_name/

Example response

Status 200
RESPONSE
{
  "skill": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "description": "string",
    "body_total_length": 0,
    "body_next_offset": 0,
    "body": "string",
    "license": "string",
    "compatibility": "string",
    "allowed_tools": [
      "string"
    ],
    "metadata": {},
    "category": "string",
    "owners": [
      {
        "id": 0,
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "distinct_id": "string",
        "first_name": "string",
        "last_name": "string",
        "email": "user@example.com",
        "is_email_verified": true,
        "hedgehog_config": {},
        "role_at_organization": "engineering"
      }
    ],
    "files": [
      {
        "path": "string",
        "content_type": "string",
        "line_count": 0,
        "char_count": 0,
        "size": 0,
        "sha256": "string"
      }
    ],
    "outline": [
      {
        "level": 1,
        "text": "string"
      }
    ],
    "spec_problems": [
      {
        "code": "string",
        "message": "string",
        "file_path": "string"
      }
    ],
    "version": 0,
    "version_description": "string",
    "created_by": {
      "id": 0,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "distinct_id": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "user@example.com",
      "is_email_verified": true,
      "hedgehog_config": {},
      "role_at_organization": "engineering"
    },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted": true,
    "is_latest": true,
    "latest_version": 0,
    "version_count": 0,
    "first_version_created_at": "string"
  },
  "versions": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "version": 0,
      "version_description": "string",
      "created_by": {
        "id": 0,
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "distinct_id": "string",
        "first_name": "string",
        "last_name": "string",
        "email": "user@example.com",
        "is_email_verified": true,
        "hedgehog_config": {},
        "role_at_organization": "engineering"
      },
      "created_at": "2019-08-24T14:15:22Z",
      "is_latest": true
    }
  ],
  "has_more": true
}