NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Planly connects to a Nagent workspace with an API key. Once it is connected, agents can call 15 Planly actions, such as "Create Team", "Get AI Credits" and "Get Team". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Planly, with input parameters and output schema.
PLANLY_COMPLETE_AI_PROMPTTool to complete a text prompt using AI. Generates AI-powered text completions based on the provided prompt. Use when you need to generate creative content, complete text, or get AI suggestions for writing tasks.
Input parameters
How many results to generate. Specify the number of AI-powered text completions to return.
Prompt as a text to be completed by AI. Provide the text content you want AI to generate completions for.
Id of team to use for AI prompt completion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_CREATE_TEAMTool to create a new team in Planly. Use when you need to create a team organization.
Input parameters
Name of the team to create.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_DELETE_MEDIATool to delete one or more media files by their IDs. Use when you need to remove media files from Planly storage.
Input parameters
Array of media IDs to delete. Each ID should be a UUID string representing a media file.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_DELETE_TEAMTool to delete a team by its ID. Use when you need to permanently remove a team from Planly.
Input parameters
Unique identifier of the team to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_EDIT_TEAMTool to edit team details such as name in Planly. Use when you need to update an existing team's information.
Input parameters
New name for the team
Team ID (UUID format)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_GET_AI_CREDITSTool to retrieve available AI credits left in a team. Use when you need to check the remaining AI credits for a specific team.
Input parameters
Id of team to retrieve AI credits for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_GET_TEAMTool to retrieve detailed information about a specific team including permissions, limits, and integrations. Use when you need to access team configuration, member counts, channel status, or integration details.
Input parameters
Team ID to retrieve information for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_IMPORT_MEDIA_FROM_URLTool to import media from a URL to your team. Use when you need to add external media (video/mp4, image/png, image/jpeg, image/webp) to a team's media library.
Input parameters
URL of the media to import. Supported media content types are video/mp4, image/png, image/jpeg, image/webp.
ID of the team to import media to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_LIST_CHANNELSTool to list all social media channels connected to a team. Use when you need to retrieve channel details including name, picture, social network type, status, and scopes.
Input parameters
ID of the team to retrieve its channels
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_LIST_MEDIATool to retrieve a paginated list of media files in a team. Use when you need to fetch media assets, browse uploaded files, or implement media management features with cursor-based pagination.
Input parameters
ID of the team to retrieve media files for
Pagination configuration for listing media.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_LIST_SCHEDULE_GROUPSTool to retrieve a list of schedule groups for a team with comprehensive filtering and pagination. Use when you need to view scheduled posts, filter by channels, status, social networks, media type, or date range. Returns detailed information about each schedule group including individual schedules and their status.
Input parameters
Array of specific schedule group IDs to retrieve. Use when you need to fetch specific schedule groups by their IDs.
Filter options for schedule groups.
ID of the team to retrieve schedule groups for. Required to scope the request to a specific team.
Date range filter for schedule groups.
Pagination options for schedule groups listing.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_LIST_SCHEDULESTool to retrieve a paginated list of schedules in a specified team. Use when you need to fetch schedules with support for pagination, custom ordering, and configurable page size. Returns schedule data with a cursor for fetching additional pages.
Input parameters
ID of the team to retrieve its schedules
Pagination configuration for list schedules request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_LIST_TEAMSTool to retrieve all teams that the authenticated user belongs to. Use when you need to get team details including id, name, picture, role, number of users, and number of channels.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_LIST_TEAM_USERSTool to list all users that belong to a specific team. Returns user details including id, fullname, picture, email, and role. Use when you need to retrieve the complete roster of team members.
Input parameters
Team ID to list users for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PLANLY_START_MEDIA_UPLOADTool to start the upload process for a media file. Returns a pre-signed upload URL where the file should be uploaded using a PUT request. Use when you need to prepare for uploading images or videos to Planly.
Input parameters
ID of the team to which the media will be uploaded
Name of the file being uploaded. Required if contentType is not provided
MIME type of the file (e.g., image/jpeg, video/mp4, image/png). Required if fileName is not provided
Size of the file in bytes
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 15 Planly actions on Nagent, including "Create Team", "Get AI Credits" and "Get Team". Create Team: Create a new team in Planly. Each action is listed on this page with its input parameters and its output.
Planly connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Team takes 1 required input: name. It returns data, error and successful.