Troubleshoot Conversational Analytics API errors

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

If you encounter issues while using the Conversational Analytics API, refer to the following table for potential solutions.

Error	Error cause	HTTP status code	gRPC status code	Resolution
AlreadyExistsException	ALREADY_EXISTS	409 Conflict	6	The resource already exists (for example, you are creating a duplicate entry). Use a different identifier or confirm that the resource doesn't already exist before creating it.
BadRequestException	INVALID_ARGUMENT	400 Bad Request	3	The input is invalid or malformed. Validate the inputs or payloads before sending the request.
ForbiddenException	PERMISSION_DENIED	403 Forbidden	7	You are authenticated but you are not allowed to access the resource. Check your user role and permissions. Contact an admin if needed.
FailedPreconditionException	FAILED_PRECONDITION	400 Bad Request	9	The request violates the system state (for example, trying to delete a non-empty folder). Check the preconditions and fix the logic.
NotFoundException	NOT_FOUND	404 Not Found	5	The resource is not found. Verify resource IDs or URLs. Ensure that the resource exists before trying to access it. See Frequently asked questions about the Conversational Analytics API for more troubleshooting information.
ServiceUnavailableException	UNAVAILABLE	503 Service Unavailable	14	There is a temporary server issue. Wait and retry with exponential backoff between attempts. If the error persists, file a bug report.
UnauthenticatedException	UNAUTHENTICATED	401 Unauthorized	16	Authentication is required, or authentication failed. Ensure that you are using the correct login credentials, API key, or token.
UnimplementedException	UNIMPLEMENTED	501 Not Implemented	12	The requested feature is not available or not supported. Avoid calling this API, or wait for implementation.

Additional resource

For additional troubleshooting tips and answers to frequently asked questions, see the Frequently asked questions about the Conversational Analytics API page.