Skip to main content
GET
/
organization-skills
/
{skill_id}
Get skill by ID
curl --request GET \
  --url https://app.usechar.ai/api/organization-skills/{skill_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "content": "<string>",
  "metadata_tokens": 0,
  "full_tokens": 0,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

WorkOS JWT token. Obtain via WorkOS AuthKit authentication flow. The token must include organization_id claim for organization-scoped endpoints.

Path Parameters

​
skill_id
string<uuid>
required

Response

OK

Full skill with content for detailed views

​
id
string
required

Internal skill record ID (UUID).

​
name
string
required

Skill name (lowercase with hyphens, 1-64 characters).

​
description
string
required

Short description of when the skill should be used.

​
content
string
required

Full SKILL.md content (frontmatter plus body).

​
metadata_tokens
integer
required

Estimated token count for metadata (frontmatter).

Required range: -9007199254740991 <= x <= 9007199254740991
​
full_tokens
integer
required

Estimated token count for the full skill content.

Required range: -9007199254740991 <= x <= 9007199254740991
​
created_at
string<date-time>
required

Timestamp when the skill was created.

​
updated_at
string<date-time>
required

Timestamp when the skill was last updated.