Voiceflow bearer token
Projects
Manage the projects that contain your agents.
See Authentication for credentials and permissions.
Returns every project in the workspace. A project is the container that owns exactly one agent. The call takes no paging parameters, so one request yields the whole set.
Authentication
Query parameters
The ID of the workspace to list projects from.
Response
Returns every project in the workspace named by workspaceID, each with its name, description, image URL, and creation and update timestamps.
Adds a project to the workspace, the container that owns exactly one agent. The response carries the ID that later calls address it by.
Authentication
Voiceflow bearer token
Request body
The ID of the workspace the project belongs to.
The channel type of the project to create.
webchat, phone-callResponse
Creates the project and returns it, including the ID that most other endpoints take as their projectID query parameter.
Returns a single project by ID, with the fields that define it. A project is the container that owns exactly one agent.
Authentication
Voiceflow bearer token
Path parameters
The ID of the project to operate on.
Response
Returns the one project, with its name, description, image URL, and the workspace that holds it.
Changes an existing project in place. The response carries only a confirmation message, so refetch the project to read its new values.
Authentication
Voiceflow bearer token
Path parameters
The ID of the project to operate on.
Request body
Response
Confirms the change to the project was saved. The response carries a message rather than the project, so read the project back to see its current name and description.
A human-readable message confirming the update.
Deletes a single project by ID. A project is the container that owns exactly one agent. The response carries only a confirmation message, so refetch the projects to see what is left.
Authentication
Voiceflow bearer token
Path parameters
The ID of the project to operate on.
Response
Confirms the project was deleted. The response is a message only, so list the workspace's projects again if you keep your own copy of them.
A human-readable message confirming the deletion.