Skills

Re-import a Skill

Re-imports a Skill that your organization imported from the Skill Catalog. The re-import replaces the name, the description and the body with the current version of the Catalog Skill, and sets source.version. The Skill keeps its slug. Edits that your organization made to the Skill are lost. Send the baseRevision you read. The answer is 409 when the re-import is not possible, and error tells why: not_imported for a Skill that your organization wrote, not_in_skill_catalog when the Catalog Skill left the Skill Catalog, no_later_version when the Skill Catalog has no later version, and revision_mismatch when the Skill changed after you read it.

post/context/skills/{slug}/re-import

Request

Base URL: https://api.adcrunch.dev
URL: https://api.adcrunch.dev/context/skills/{slug}/re-import
Auth: HTTP bearer

Path parameters

slugstring required

The slug of the imported Skill in your organization.

Request body

baseRevisioninteger required

The revision last read via GET. A re-import replaces the content of the Skill, so it guards the content that you read.

Example request

{
  "baseRevision": 2
}

Response

The Skill with the content of the later version, at the next revision. This shape was not observed against a deployed service, because no stage held a later version of a Catalog Skill: it is written from the Context Layer’s view type.

bodystring required

The agent instructions themselves — the SKILL.md-equivalent, in markdown.

createdAtnumber required

Milliseconds since the Unix epoch, UTC.

createdBystring required

descriptionstring required

idstring required

namestring required

revisionnumber required

Increments on every write. Send it back as base_revision to edit; a stale one answers 409.

slugstring required

updatedAtnumber nullable required

Milliseconds since the Unix epoch, UTC.

Example response

{
  "body": "## When to run\n\nEvery Monday, before the week starts.\n\n## Steps\n\n1. Call `list_campaigns` for each advertiser.\n2. Call `query_insights` for the last seven days.\n3. Write down the campaigns that missed their target.",
  "createdAt": 1790000000000,
  "createdBy": "usr_4d8b12",
  "description": "Use it every Monday to review the spend and the results of last week.",
  "id": "skl_7c1f90",
  "name": "Weekly performance review",
  "revision": 3,
  "slug": "weekly-performance-review",
  "source": {
    "slug": "weekly-performance-review",
    "version": "2026-11-02"
  },
  "updatedAt": 1791000000000
}

Changes

No recorded changes to this operation across all 1 revision of this API.