agentSkills

Creates an independent user-owned copy of a readable skill and its supporting content.

Changed on

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

post/agents/skills/{skillId}/duplicate

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/agents/skills/{skillId}/duplicate
  • Auth: HTTP bearer

Path parameters

skillIdstring uuid required

The source skill ID.

Query parameters

agentIdstring uuid

The optional linked agent granting read access to the source.

Request body

keystring nullable

The stable key for the copy.

namestring required

The display name for the copy.

Response

OK

idstring uuid

The skill identifier.

createdBystring uuid

The user who created the skill.

createdOnstring date-time

When the skill was created.

updatedOnstring date-time nullable

When the skill was last updated.

keystring nullable

The stable key used to reference the skill.

namestring nullable

The name shown in the skill library.

descriptionstring nullable

A short explanation of what the skill does.

instructionsstring nullable

The Markdown instruction body from SKILL.md.

instructionsSourcestring nullable

The source from which the instructions were created.

type'user' | 'agent'

The ownership type.

userIdstring uuid nullable

The owning user for a user-owned skill.

agentIdstring uuid nullable

The owning agent for an agent-owned skill.

accessLevel'read' | 'manage'

The requesting user's resolved access level.

isOwnerboolean

Whether the requesting user owns the skill.

hasAdminAccessOnlyboolean

Whether the skill is visible only through workspace administration access.

workspaceAccessLevel'read' | 'manage'

The workspace-wide access level.

linkedAgentCountinteger

The number of linked agents.

metadatastring nullable

The skill frontmatter as a JSON object.

hasFilesboolean

Whether the skill includes bundled files.

Changes