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`

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/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.get(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/".format(
        project_id=project_id
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

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"
        }
      ],
      "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

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
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"
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.post(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/".format(
        project_id=project_id
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
	data={
		"name": "string",
		"description": "string",
		"body": "string"
	}
).json()

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
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "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/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.get(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/bundle/".format(
        project_id=project_id
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

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
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "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/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.get(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/marketplace/install-command/".format(
        project_id=project_id
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

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"
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.post(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/marketplace/install-command/".format(
        project_id=project_id
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
	data={
		"rotate": "boolean"
	}
).json()

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/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.get(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

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
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "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
array
description
string
license
string
compatibility
string
allowed_tools
array
metadata
object
files
array
file_edits
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"
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.patch(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
	data={
		"body": "string"
	}
).json()

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
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "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/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.post(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/archive/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

Example response

Status 204 No response body

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"
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.post(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/duplicate/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
	data={
		"new_name": "string"
	}
).json()

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
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "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/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.get(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/export/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

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"
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.post(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/files/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
	data={
		"path": "string",
		"content": "string"
	}
).json()

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
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "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"
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.post(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/files-rename/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
	data={
		"old_path": "string",
		"new_path": "string"
	}
).json()

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
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "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/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.get(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/files/{file_path}/".format(
        project_id=project_id,
		file_path="<the file path>",,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

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/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.delete(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/files/{file_path}/".format(
        project_id=project_id,
		file_path="<the file path>",,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
)

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
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "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

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 display_name=undefined
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.post(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/publish-community/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
	data={}
).json()

Example response

Status 201

RESPONSE
{
  "pr_url": "http://example.com",
  "pr_number": 0,
  "branch": "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"
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.post(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/name/{skill_name}/rename/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
	data={
		"new_name": "string"
	}
).json()

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
    }
  ],
  "outline": [
    {
      "level": 1,
      "text": "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 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/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.get(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/resolve/name/{skill_name}/".format(
        project_id=project_id,
		skill_name="<the skill name>"
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

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
      }
    ],
    "outline": [
      {
        "level": 1,
        "text": "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
}

Retrieve llm skills search

Required API key scopes

llm_skill:read

Query parameters

query
string

Response

Example request

GET /api/projects/:project_id/llm_skills/search
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/search/
api_key = "[your personal api key]"
project_id = "[your project id]"
response = requests.get(
    "<ph_app_host>/api/projects/{project_id}/llm_skills/search/".format(
        project_id=project_id
    ),
    headers={"Authorization": "Bearer {}".format(api_key)},
).json()

Example response

Status 200

RESPONSE
{
  "count": 0,
  "results": [
    {
      "name": "string",
      "description": "string",
      "matches": [
        {
          "matched_field": "name",
          "path": "string",
          "line": 1,
          "excerpt": "string"
        }
      ]
    }
  ]
}

Status 503 The bounded skill search exceeded its database timeout.

RESPONSE
{
  "detail": "string"
}