Update a skill's envelope

Update a skill's envelope

cURL

curl --request PATCH \
  --url https://agentgateway.atlan.engineering/skill/v1/skills/{skill_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

200

{
  "artifact_status": "<string>",
  "commit_ts": "<string>",
  "content_hash_hex": "<string>",
  "created_at": "<string>",
  "created_by": "<string>",
  "extension": "<string>",
  "id": "<string>",
  "is_latest": true,
  "kind": "<string>",
  "name": "<string>",
  "source_type": "<string>",
  "updated_at": "<string>",
  "updated_by": "<string>",
  "version_ordinal": 123,
  "workspace_id": "<string>",
  "display_name": "<string>",
  "identity": {
    "client_id": "<string>",
    "credential_kind": "<string>",
    "api_key": "<string>",
    "expires_at": "<string>"
  },
  "oidc_client_id": "<string>",
  "owner_id": "<string>",
  "project_id": "<string>",
  "repo_id": "<string>",
  "source_created_at": "<string>",
  "source_created_by": "<string>",
  "source_digest": "<string>",
  "source_id": "<string>",
  "source_last_modified_at": "<string>",
  "source_last_modified_by": "<string>",
  "source_metadata": "<unknown>",
  "source_synced_at": "<string>",
  "source_uri": "<string>",
  "source_version": "<string>",
  "version_label": "<string>",
  "allowed_tools": [
    "<string>"
  ],
  "argument_hint": "<string>",
  "arguments": [
    "<string>"
  ],
  "asset_file_count": 123,
  "code_file_count": 123,
  "compatibility": "<string>",
  "doc_file_count": 123,
  "executable_file_count": 123,
  "file_count": 123,
  "files": [
    {
      "content_uri": "<string>",
      "file_id": "<string>",
      "file_version_ordinal": 123,
      "media_type": "<string>",
      "path": "<string>",
      "size_bytes": 123,
      "source_digest": "<string>",
      "is_executable": true
    }
  ],
  "frontmatter_metadata": "<unknown>",
  "has_executable_files": true,
  "is_model_invocable": true,
  "is_system": true,
  "is_user_invocable": true,
  "largest_file_bytes": 123,
  "license": "<string>",
  "lifecycle": "draft",
  "max_depth": 123,
  "raw_frontmatter": "<unknown>",
  "skill_version": "<string>",
  "summary": "<string>",
  "total_bytes": 123,
  "upload_sha256": "<string>",
  "when_to_use": "<string>",
  "permissions": {},
  "relationships": {
    "count": 1,
    "incoming": [
      {
        "direction": "<string>",
        "provenance": "<string>",
        "rel_type": "<string>",
        "relationship_status": "<string>",
        "attributes": {},
        "confidence": 123,
        "from": {
          "id": "<string>",
          "kind": "<string>"
        },
        "label": "<string>",
        "role": "<string>",
        "to": {
          "id": "<string>",
          "kind": "<string>"
        },
        "weight": 123
      }
    ],
    "outgoing": [
      {
        "direction": "<string>",
        "provenance": "<string>",
        "rel_type": "<string>",
        "relationship_status": "<string>",
        "attributes": {},
        "confidence": 123,
        "from": {
          "id": "<string>",
          "kind": "<string>"
        },
        "label": "<string>",
        "role": "<string>",
        "to": {
          "id": "<string>",
          "kind": "<string>"
        },
        "weight": 123
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

skill_id · string · required

Body

application/json

name · string | null

Response

200

application/json

HTTP 200 response.

artifact_status · string · required

commit_ts · string · required

content_hash_hex · string · required

created_at · string · required

created_by · string · required

extension · string · required

id · string · required

is_latest · boolean · required

kind · string · required

name · string · required

source_type · string · required

updated_at · string · required

updated_by · string · required

version_ordinal · integer<int64> · required

workspace_id · string · required

display_name · string

identity · null | object

Show child attributes

oidc_client_id · string | null

owner_id · string | null

project_id · string | null

repo_id · string | null

source_created_at · string | null

source_created_by · string | null

source_digest · string | null

source_id · string | null

source_last_modified_at · string | null

source_last_modified_by · string | null

source_metadata · any

source_synced_at · string | null

source_uri · string | null

source_version · string | null

version_label · string | null

allowed_tools · string[]

argument_hint · string | null

arguments · string[]

asset_file_count · integer<int64>

code_file_count · integer<int64>

compatibility · string | null

doc_file_count · integer<int64>

executable_file_count · integer<int64>

file_count · integer<int64>

files · object[]

Show child attributes

frontmatter_metadata · any

has_executable_files · boolean

is_model_invocable · boolean

is_system · boolean

is_user_invocable · boolean

largest_file_bytes · integer<int64>

license · string

lifecycle · enum<string>

Available options: draft, active, deprecated

max_depth · integer<int64>

raw_frontmatter · any

skill_version · string | null

summary · string

total_bytes · integer<int64>

upload_sha256 · string | null

when_to_use · string | null

permissions · null | object

Show child attributes

relationships · null | object

Show child attributes