AWawork-io
customAgents

Copies an existing custom agent.

Changed on

Creates a copy of an existing custom agent in the current workspace. Provide the new name and optional description in the request body. The source agent supplies the initial configuration and system prompt. Returns the new agent with its own id. <Check title="Required Permissions" icon="key">The user must have read access to the source agent.</Check>

post/agents/{agentId}/copy

Request

  • Base URL
    https://api.awork.com/api/v1
  • URL
    https://api.awork.com/api/v1/agents/{agentId}/copy
  • Auth
    HTTP bearer

Path parameters

agentIdstring uuid required

The source agent id.

Request body

namestring nullable

The name shown to users.

descriptionstring nullable

A short explanation of what the agent does.

Response

OK

idstring uuid

The id of the entity.

createdOnstring date-time

The date this entity was created.

createdBystring uuid

The id of the user who created this entity.

updatedOnstring date-time

The date this entity was last modified.

updatedBystring uuid

The id of the user who last modified this entity.

typestring nullable

The public agent type.

namestring nullable

The name shown to users.

descriptionstring nullable

A short explanation of what the agent does.

currentSystemPromptVersionIdstring uuid nullable

The current system prompt version.

modelProviderstring nullable

The configured model provider when no preset is selected.

modelNamestring nullable

The configured model name when no preset is selected.

presetKeystring nullable

The configured workspace model preset key.

reasoningLevelstring nullable

The configured reasoning level.

systemPromptstring nullable

The current system prompt.

webSearchEnabledboolean

Whether web search is enabled.

aworkAccessEnabledboolean

Whether awork access is enabled.

googleGenAiAccessEnabledboolean

Whether Google image generation is enabled.

openAiImageGenerationAccessEnabledboolean

Whether OpenAI image generation is enabled.

skillIdsstring[] nullable

The skills linked to the agent.

hasImageboolean

Whether the agent has a profile image.

isArchivedboolean

Whether the agent is archived.

workspaceAccessLevel'read' | 'manage'

The workspace-wide access level.

hasAdminAccessOnlyboolean

Whether the agent is visible only through workspace administration access.

accessLevel'read' | 'manage'

The requesting user's access level.

Changes

  • 84f37b3c4cbcRevision changes
    • info

      added the optional property to the response with the status

  • 5332322ffca3Revision changes
    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status