Skills sync pending

GET/v1/skill-sync

Signed-in sessionLaunch key product.skillsOperation skills_sync_pending

People keep their agent skills and Rules in Specify and the specify CLI syncs them to every agent provider on each of their machines.

Query parameters

expectedAuthorizationVersionstring
selectstring

Returns

contextobjectRequired
permission"not_permitted" | "permitted"Required
itemsobject[]Required
countobjectRequired
freshnessobjectRequired

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.

GET/v1/skill-sync

curl "$SPECIFY_API_ORIGIN/v1/skill-sync" \
  -H "Authorization: Bearer $SPECIFY_SESSION_TOKEN" \
  -H "X-Specify-Account-Id: <accountId>" \
  -H "X-Specify-Service-Tenancy-Id: <serviceTenancyId>"

Response

{
  "result": {
    "context": {
      "accountId": "<accountId>",
      "serviceTenancyId": "<serviceTenancyId>",
      "authorizationVersion": "<authorizationVersion>"
    },
    "permission": "not_permitted",
    "items": [
      {
        "skillId": "<skillId>",
        "name": "<name>",
        "kind": "rules",
        "versionId": "<versionId>",
        "number": 1,
        "contentHash": "<contentHash>",
        "description": "<description>",
        "surfaceChanges": [
          "<surfaceChange>"
        ],
        "firstVersion": true,
        "preselected": true,
        "createdAt": 1
      }
    ],
    "count": {
      "kind": "exact",
      "value": 1
    },
    "freshness": {
      "source": "canonical",
      "asOf": 1,
      "state": "catching_up",
      "watermark": "<watermark>"
    }
  }
}

Skills sync pending

Headers

Query parameters

Returns

Errors