API Changes from Folder to Label endpoints and how to add/remove Labels on Forms

We've recently been switched to the Labels API from the Folders API and are now trying to understand how to add/remove Labels on Forms. I seen this API Endpoint Error: This action/API endpoint is not available to users who are using the Labels feature support thread, but it does not mention anything about updating Forms/Labels.

The existing PUT /folder/{id} API endpoint allowed us to set the Form IDs of the Folder to essentially move the Forms to that destination. What is the equivalent API we should use for Labels?

Hi Bill,

Thanks for reaching out to us for help. I'm an AI assistant. I'll do my best to help you until someone from the support team is available.

Regarding your question about the transition from the Folders API to the Labels API and how to add or remove Labels on Forms, the existing PUT /folder/{id} endpoint you used to set Form IDs for folders is no longer applicable with Labels.

Unfortunately, the Labels API does not provide a direct equivalent endpoint to move Forms by setting their Label IDs in the same way as the Folder API did. The API endpoint error you encountered indicates that certain actions are restricted for users using the Labels feature.

To manage Labels on Forms, you will need to use the specific Labels API endpoints designed for adding or removing Labels. These endpoints allow you to assign or unassign Labels to Forms, but the exact method differs from the Folder API approach.

For detailed instructions and the correct API usage to add or remove Labels on Forms, I recommend consulting the latest Jotform API documentation on Labels. This will provide the current supported endpoints and methods for managing Labels on your Forms.

If you need further assistance or specific examples on how to use the Labels API for your Forms, please let me know.

Reach out again if you need any other help.

Hi Bill,

The endpoints have been recently updated since we migrated Folder to Labels. Can you try the following endpoints?

/label/{$labelId}

user/labels

They were previously like the codes below:

/folder/{$folderId}

/user/folders

For example, you can use following API call to find the label ID of your workspace labels.

https://api.jotform.com/user/labels

https://api.jotform.com/user/labels?addResources=1

Then, once you have the ID of your label, you can use the following call to fetch the forms under the label.

https://api.jotform.com/label/{labelID}/resources?offset=0&limit=30&orderby=created_at&status=active

Update a label with specified parameters such as name and color.

PUT/label/{id}

Add given assets into labels.

PUT/label/{id}/add-resources

Remove given assets from labels.

PUT/label/{id}/remove-resources

Delete a label and its sublabels.

DELETE/label/{id}

Give it a try and let us know if you need any help.